This guide explains how to add A2Agent as a model provider in Cherry Studio and start using DeepSeek, Kimi, GLM, MiniMax, and more.
A2Agent is a unified API gateway that provides access to multiple models through a single API endpoint and API key. Model availability, usage limits, and billing are managed through your A2Agent account.
Open Cherry Studio. On the home page, select Set up another provider, then click Add provider.
2. Fill in the Provider Information
Provider Name: Custom, e.g. A2Agent
API Key: Your A2Agent API key
API Request URL: https://api.a2agent.me/v1
3. Fetch and Select Models
In the model configuration section, click Get model list. After Cherry Studio fetches the models from A2Agent, select the models you want to use and save the provider configuration.
The model list will be updated dynamically as models evolve.
Start Using A2Agent Models
After the configuration is saved, go back to the conversation page in Cherry Studio, switch to the A2Agent provider in the model picker, and choose an enabled model to start chatting.
Troubleshooting
The model list fails to load: Verify that your API key is valid, your account has available balance, and your network can reach https://api.a2agent.me/v1.
The model list is empty: Make sure the provider information and model configuration were saved, then fetch the model list again.
Models are still unavailable: Restart Cherry Studio and try again.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"A2Agent Docs","description":"Cheapest AI model API gateway for leading powerful LLMs — one key for GLM, Kimi, DeepSeek, Qwen, MiniMax, and more.","colors":{"primary":"#14B8A6","light":"#2DD4BF","dark":"#0D9488"},"logo":{"light":"https://mintcdn.com/a2agent/lBABEgkjV2AuzSft/images/a2agent-docs-logo-dark.svg?fit=max\u0026auto=format\u0026n=lBABEgkjV2AuzSft\u0026q=85\u0026s=cd9dfdc08f55cf0e32adeda25098bfca","dark":"https://mintcdn.com/a2agent/lBABEgkjV2AuzSft/images/a2agent-docs-logo-light.svg?fit=max\u0026auto=format\u0026n=lBABEgkjV2AuzSft\u0026q=85\u0026s=0b4dc7ee8ee4431db5eb7ebd2678522d","href":"https://a2agent.me"},"favicon":{"light":"https://mintcdn.com/a2agent/YxBl9PMSeJZpuoiz/images/logo.png?fit=max\u0026auto=format\u0026n=YxBl9PMSeJZpuoiz\u0026q=85\u0026s=f4fdc1a5009ef365fcb4109a99b0a83f","dark":"https://mintcdn.com/a2agent/YxBl9PMSeJZpuoiz/images/logo.png?fit=max\u0026auto=format\u0026n=YxBl9PMSeJZpuoiz\u0026q=85\u0026s=f4fdc1a5009ef365fcb4109a99b0a83f"},"background":{"decoration":"gradient","color":{"light":"#FFFFFF","dark":"#020617"}},"navbar":{"links":[{"href":"https://a2agent.me/models","label":"Models"},{"href":"https://a2agent.me/about","label":"Contact us"}],"primary":{"type":"button","label":"Get Free API Key","href":"https://a2agent.me/register"}},"footer":{"socials":{"discord":"https://discord.gg/mXXKq8NbyA","github":"https://github.com/A2agent-ai","x":"https://x.com/a2agent_ai"},"links":[{"header":"Product","items":[{"label":"What is A2Agent","href":"https://a2agent.me/what-is-a2agent"},{"label":"Browse Models","href":"https://a2agent.me/models"},{"label":"Pricing","href":"https://a2agent.me/pricing"}]},{"header":"Resources","items":[{"label":"FAQ","href":"https://docs.a2agent.me/help/faq"},{"label":"llms.txt","href":"https://docs.a2agent.me/llms.txt"},{"label":"llms-full.txt","href":"https://docs.a2agent.me/llms-full.txt"}]},{"header":"Company","items":[{"label":"Terms of Service","href":"https://a2agent.me/terms"},{"label":"Privacy Policy","href":"https://a2agent.me/privacy"}]}]},"seo":{"indexing":"all"},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"ga4":{"measurementId":"G-6YRW83R297"}},"contextual":{"options":["copy","view","assistant","mcp","add-mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"a2agent","hasAudioNarration":false,"actualSubdomain":"a2agent","customDomains":["docs.a2agent.me"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-a2agent-8e7d48b2","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6acb69384f34638a069549ed","clientVersion":"0.0.4131","searchFilterCounts":[{"language":"default","tag":"Integrations","count":17},{"language":"default","tag":"Documentation","count":10},{"language":"default","tag":"Coding CLI Agents","count":8},{"language":"default","tag":"Desktop \u0026 IDE Clients","count":6},{"language":"default","tag":"API Reference","count":5},{"language":"default","tag":"Account","count":3},{"language":"default","tag":"Endpoints","count":3},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Overview","count":2},{"language":"default","tag":"Chat \u0026 GUI Apps","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--default-border-color: var(--gray-200)}.dark{--default-border-color: var(--gray-800)}#sidebar .nav-dropdown-trigger{border:none!important;background:transparent!important;box-shadow:none!important;padding-left:0.375rem}#sidebar .nav-dropdown-trigger:hover{background-color:rgb(0 0 0 / 0.04)!important}.dark #sidebar .nav-dropdown-trigger:hover{background-color:rgb(255 255 255 / 0.06)!important}#sidebar .nav-dropdown-trigger .nav-dropdown-item-icon{border:none!important;background:transparent!important;height:auto!important;width:auto!important;padding:0!important}.nav-dropdown-content{}.nav-dropdown-content .nav-dropdown-item{}.nav-dropdown-content .nav-dropdown-item-icon{border:none!important;background:transparent!important;height:auto!important;width:auto!important;padding:0!important}.nav-dropdown-content .nav-dropdown-item-description{display:none!important}#sidebar .nav-anchor span{font-family:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;font-size:12px;font-weight:500;letter-spacing:-0.02em;text-transform:uppercase}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"]{color:rgb(var(--primary))!important;font-weight:600!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"] span{color:inherit!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"] svg{background-color:rgb(var(--primary))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"]{color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"] svg{background-color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}:is(#content-area[data-current-path=\"/\"],[data-current-path=\"/\"] #content-area):has([data-product-guide-index]){background:transparent!important;padding:0!important}:is(#content-area[data-current-path=\"/\"],[data-current-path=\"/\"] #content-area):has([data-product-guide-index])>div:first-child{background:transparent!important;padding-right:0!important;padding-bottom:0!important;padding-left:0!important}[data-product-guide-index] a:not(.product-guide-feature-card){background-color:#fafafa!important}.dark [data-product-guide-index] a:not(.product-guide-feature-card){background-color:#09090b!important}.product-guide-feature-card{grid-column:1 / -1;display:flex!important;flex-direction:column!important;justify-content:space-between!important;min-height:260px;background:url('/images/sample-feature-light.png') center / cover no-repeat!important;border:none!important;box-shadow:none!important;color:white!important;.dark \u0026 {\n background-image: url('/images/sample-feature-dark.png') !important;\n }}.product-guide-feature-card>div{display:flex!important;flex:1;flex-direction:column!important;justify-content:space-between!important}.product-guide-feature-card :is(h2,h3,p,span,svg){color:white!important}.product-guide-feature-card :is(svg,[class*=\"icon\"]){background-color:white!important;width:2em!important;height:2em!important;margin-top:2px}.product-guide-feature-card-title{font-size:1.2em;font-weight:500}.product-guide-feature-card :is(h2,h3,p,span,svg).product-guide-feature-card-description{font-size:1.05em;font-weight:400;color:rgb(var(--gray-50) / 62.5%)!important;.dark \u0026 {\n color: rgb(var(--gray-50) / 50%) !important;\n }}img.nav-logo{max-width:220px;height:auto}"}],"page":{"pagePath":"clients/cherry-studio","slug":"/clients/cherry-studio","pageMetadata":{"sidebarTitle":"Cherry Studio","title":"Use A2Agent Models with Cherry Studio","description":"This guide explains how to add A2Agent as a model provider in Cherry Studio and start using DeepSeek, Kimi, GLM, MiniMax, and more.","href":"/clients/cherry-studio"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"This guide explains how to add A2Agent as a model provider in Cherry Studio and start using DeepSeek, Kimi, GLM, MiniMax, and more.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,OptimizedImage,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`A2Agent is a unified API gateway that provides access to multiple models through a single API endpoint and API key. Model availability, usage limits, and billing are managed through your A2Agent account.`}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`https://cherry-ai.com/download`,children:`Cherry Studio`}),` installed`]}),`\n`,_jsxs(_components.li,{children:[`An A2Agent API key — `,_jsx(_components.a,{href:`https://a2agent.me/register`,children:`sign up at a2agent.me/register`}),` to get one`]}),`\n`,_jsxs(_components.li,{children:[`API request URL: `,_jsx(_components.code,{children:`https://api.a2agent.me`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`setup`,children:`Setup`}),`\n`,_jsx(Heading,{level:`3`,id:`1-add-a-provider`,children:`1. Add a Provider`}),`\n`,_jsxs(_components.p,{children:[`Open Cherry Studio. On the home page, select `,_jsx(_components.strong,{children:`Set up another provider`}),`, then click `,_jsx(_components.strong,{children:`Add provider`}),`.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-16.png?fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=07002e610d03f5cd577b3a5a908d0b19`,alt:`Image`,\"data-og-width\":`961`,width:`961`,\"data-og-height\":`599`,height:`599`,\"data-path\":`images/image-16.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-16.png?w=280\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=4d03d5cad9e39890d516f58d95a18049 280w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-16.png?w=560\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=ab8751d03216dbfbd305c4830fa52633 560w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-16.png?w=840\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=3d2adb4300de59302bc3566501612490 840w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-16.png?w=1100\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=1ca70904a51746ec5ecef562e864c694 1100w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-16.png?w=1650\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=9de36753ff0c2e44ed264a343c9bbb12 1650w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-16.png?w=2500\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=f5f451f1d2e67830ea7e8fb0f3dac3a3 2500w`}),`\n`,_jsx(Heading,{level:`3`,id:`2-fill-in-the-provider-information`,children:`2. Fill in the Provider Information`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Provider Name`}),`: Custom, e.g. `,_jsx(_components.code,{children:`A2Agent`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`API Key`}),`: Your A2Agent API key`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`API Request URL`}),`: `,_jsx(_components.code,{children:`https://api.a2agent.me/v1`}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-17.png?fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=afc72acf342a01c6c2dee96867b122d5`,alt:`Image`,\"data-og-width\":`575`,width:`575`,\"data-og-height\":`283`,height:`283`,\"data-path\":`images/image-17.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-17.png?w=280\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=33c0dd62a1d786576a0442c87a197318 280w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-17.png?w=560\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=10d386f8ff1153abae4c383b57f88080 560w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-17.png?w=840\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=cb97a6ac612d5118c75011b9263e2236 840w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-17.png?w=1100\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=5695383f04b4b6bd837f402b2017f840 1100w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-17.png?w=1650\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=412a0dc092074bd8be1c72c35d313a12 1650w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-17.png?w=2500\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=58f3c334a136fea5571dc65030affa8f 2500w`}),`\n`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`3-fetch-and-select-models`,children:`3. Fetch and Select Models`}),`\n`,_jsxs(_components.p,{children:[`In the model configuration section, click `,_jsx(_components.strong,{children:`Get model list`}),`. After Cherry Studio fetches the models from A2Agent, select the models you want to use and save the provider configuration.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-18.png?fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=5b0e15fb2f3181e33056a394a351b7e5`,alt:`Image`,\"data-og-width\":`616`,width:`616`,\"data-og-height\":`488`,height:`488`,\"data-path\":`images/image-18.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-18.png?w=280\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=eae9616f6f53ed506942f8287ab97a4f 280w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-18.png?w=560\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=23204af9c9a332e446511928cac79380 560w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-18.png?w=840\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=e7b7218556c490825d864418fa53617e 840w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-18.png?w=1100\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=af57a71b8bc511d03e2a27d7169543b2 1100w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-18.png?w=1650\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=d844c0238eece7375f9c77b73440e1e4 1650w, https://mintcdn.com/a2agent/o_cDCynQVxMS3HPX/images/image-18.png?w=2500\u0026fit=max\u0026auto=format\u0026n=o_cDCynQVxMS3HPX\u0026q=85\u0026s=f452d921ea59d8428d3f244ad4cde5db 2500w`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:_jsx(_components.strong,{children:`The model list will be updated dynamically as models evolve.`})})}),`\n`,_jsx(Heading,{level:`2`,id:`start-using-a2agent-models`,children:`Start Using A2Agent Models`}),`\n`,_jsx(_components.p,{children:`After the configuration is saved, go back to the conversation page in Cherry Studio, switch to the A2Agent provider in the model picker, and choose an enabled model to start chatting.`}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The model list fails to load`}),`: Verify that your API key is valid, your account has available balance, and your network can reach `,_jsx(_components.code,{children:`https://api.a2agent.me/v1`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The model list is empty`}),`: Make sure the provider information and model configuration were saved, then fetch the model list again.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Models are still unavailable`}),`: Restart Cherry Studio and try again.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"sidebarTitle":"Cherry Studio","title":"Use A2Agent Models with Cherry Studio","description":"This guide explains how to add A2Agent as a model provider in Cherry Studio and start using DeepSeek, Kimi, GLM, MiniMax, and more.","href":"/clients/cherry-studio"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Setup","slug":"setup","depth":2,"children":[{"title":"1. Add a Provider","slug":"1-add-a-provider","depth":3,"children":[]},{"title":"2. Fill in the Provider Information","slug":"2-fill-in-the-provider-information","depth":3,"children":[]},{"title":"3. Fetch and Select Models","slug":"3-fetch-and-select-models","depth":3,"children":[]}]},{"title":"Start Using A2Agent Models","slug":"start-using-a2agent-models","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"a2agent","siteName":"A2Agent Docs","title":"Use A2Agent Models with Cherry Studio - A2Agent Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-14T03:24:57.453Z","originalFileLocation":"clients/cherry-studio.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"This guide explains how to add A2Agent as a model provider in Cherry Studio and start using DeepSeek, Kimi, GLM, MiniMax, and more.\">\u003cmeta data-mint-head name=\"application-name\" content=\"A2Agent Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Use A2Agent Models with Cherry Studio - A2Agent Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"This guide explains how to add A2Agent as a model provider in Cherry Studio and start using DeepSeek, Kimi, GLM, MiniMax, and more.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"A2Agent Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.a2agent.me/clients/cherry-studio\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://a2agent.mintlify.site/_mintlify/api/og/v2?division=Chat+%26+GUI+Apps\u0026amp;title=Use+A2Agent+Models+with+Cherry+Studio\u0026amp;description=This+guide+explains+how+to+add+A2Agent+as+a+model+provider+in+Cherry+Studio+and+start+using+DeepSeek%2C+Kimi%2C+GLM%2C+MiniMax%2C+and+more.\u0026amp;theme=79d26ab45fbefc0bce66ab88\u0026amp;signature=f4d34ae0690aa5483bacde9967d39c100c47b32451c3ce3cfda63940e9cbc259\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Use A2Agent Models with Cherry Studio - A2Agent Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This guide explains how to add A2Agent as a model provider in Cherry Studio and start using DeepSeek, Kimi, GLM, MiniMax, and more.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://a2agent.mintlify.site/_mintlify/api/og/v2?division=Chat+%26+GUI+Apps\u0026amp;title=Use+A2Agent+Models+with+Cherry+Studio\u0026amp;description=This+guide+explains+how+to+add+A2Agent+as+a+model+provider+in+Cherry+Studio+and+start+using+DeepSeek%2C+Kimi%2C+GLM%2C+MiniMax%2C+and+more.\u0026amp;theme=79d26ab45fbefc0bce66ab88\u0026amp;signature=f4d34ae0690aa5483bacde9967d39c100c47b32451c3ce3cfda63940e9cbc259\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/a2agent/diVxrAAjJ9uEClj4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"A2Agent Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#14B8A6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.a2agent.me/clients/cherry-studio\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/clients/cherry-studio.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.a2agent.me/#organization\",\"name\":\"A2Agent Docs\",\"url\":\"https://docs.a2agent.me\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/a2agent/lBABEgkjV2AuzSft/images/a2agent-docs-logo-dark.svg?fit=max\u0026auto=format\u0026n=lBABEgkjV2AuzSft\u0026q=85\u0026s=cd9dfdc08f55cf0e32adeda25098bfca\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.a2agent.me#website\",\"name\":\"A2Agent Docs\",\"url\":\"https://docs.a2agent.me\",\"publisher\":{\"@id\":\"https://docs.a2agent.me/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.a2agent.me/clients/cherry-studio#webpage\",\"url\":\"https://docs.a2agent.me/clients/cherry-studio\",\"name\":\"Use A2Agent Models with Cherry Studio\",\"description\":\"This guide explains how to add A2Agent as a model provider in Cherry Studio and start using DeepSeek, Kimi, GLM, MiniMax, and more.\",\"dateModified\":\"2026-09-14T03:24:57.453Z\",\"isPartOf\":{\"@id\":\"https://docs.a2agent.me#website\"},\"breadcrumb\":{\"@id\":\"https://docs.a2agent.me/clients/cherry-studio#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.a2agent.me/clients/cherry-studio#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Chat \u0026 GUI Apps\",\"item\":\"https://docs.a2agent.me/clients/chatbox\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Use A2Agent Models with Cherry Studio\",\"item\":\"https://docs.a2agent.me/clients/cherry-studio\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.a2agent.me/clients/cherry-studio#article\",\"headline\":\"Use A2Agent Models with Cherry Studio\",\"name\":\"Use A2Agent Models with Cherry Studio\",\"description\":\"This guide explains how to add A2Agent as a model provider in Cherry Studio and start using DeepSeek, Kimi, GLM, MiniMax, and more.\",\"url\":\"https://docs.a2agent.me/clients/cherry-studio\",\"mainEntityOfPage\":{\"@id\":\"https://docs.a2agent.me/clients/cherry-studio#webpage\"},\"dateModified\":\"2026-09-14T03:24:57.453Z\",\"publisher\":{\"@id\":\"https://docs.a2agent.me/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.a2agent.me#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"A2Agent Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"A2Agent Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/clients/cherry-studio.md","siteName":"A2Agent Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"Integrations","groups":[{"group":"Coding CLI Agents","pages":[{"title":"Claude Code with A2Agent: Anthropic-Compatible Endpoint","sidebarTitle":"Claude Code","href":"/clients/claude-code"},{"title":"Use Cline CLI with A2Agent","sidebarTitle":"Cline CLI","href":"/clients/cline"},{"title":"Use OpenAI Codex CLI with A2Agent for Cheaper Models","sidebarTitle":"Codex CLI","href":"/clients/codex-cli"},{"title":"Use Hermes CLI with A2Agent ","sidebarTitle":"Hermes CLI","href":"/clients/hermes-cli"},{"title":"Use Kilo Code CLI with A2Agent for Lower-Cost Models","sidebarTitle":"Kilo Code CLI","href":"/clients/kilo"},{"sidebarTitle":"OMP CLI","title":"Use Oh My Pi (OMP) with A2Agent","href":"/clients/omp"},{"title":"Use A2Agent with OpenCode CLI","sidebarTitle":"Open Code CLI","href":"/clients/opencode-cli"},{"title":"Use Pi Coding Agent with A2Agent for Lower-Cost Models","sidebarTitle":"pi-agent CLI","href":"/clients/pi-agent"}]},{"group":"Desktop \u0026 IDE Clients","pages":[{"title":"Use A2Agent Models with Claude Desktop (CC Switch Setup Guide)","sidebarTitle":"Claude Desktop","href":"/clients/claude-desktop"},{"sidebarTitle":"Codex Desktop Direct","title":"Use A2Agent Models with Codex Desktop (Direct)","href":"/clients/codex-desktop-direct"},{"title":"Use A2Agent Models with Codex Desktop (CC Switch Setup Guide)","sidebarTitle":"Codex Desktop With CC-Switch","href":"/clients/codex-desktop-ccswitch"},{"title":"Use A2Agent Models with Continue","sidebarTitle":"Continue","href":"/clients/continue"},{"sidebarTitle":"Open Code Desktop","title":"Use A2Agent Models with Open Code Desktop","href":"/clients/opencode-desktop"},{"sidebarTitle":"WorkBuddy","title":"Use WorkBuddy with A2Agent for Lower-Cost Models","href":"/clients/workbuddy"}]},{"group":"Chat \u0026 GUI Apps","pages":[{"sidebarTitle":"Chatbox","title":"Use A2Agent Models with Chatbox","description":"This guide explains how to add A2Agent as a model provider in Chatbox and start using DeepSeek, Kimi, GLM, MiniMax, and more.","href":"/clients/chatbox"},{"sidebarTitle":"Cherry Studio","title":"Use A2Agent Models with Cherry Studio","href":"/clients/cherry-studio"}]},{"group":"Local Runtimes / Harnesses","pages":[{"sidebarTitle":"DeepSeek Harness","title":"Use DeepSeek Harness with A2Agent","description":"Run DeepSeek Harness locally and connect it to A2Agent through the Web UI. Use DeepSeek, Kimi, GLM, MiniMax, Qwen, and other supported models through a single A2Agent API key.","href":"/clients/deepseek-harness"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]}]},"basePath":"","title":"Use A2Agent Models with Cherry Studio - A2Agent Docs","buildId":"dpl_5joLUXmnJgwqjrHAS4dxZrQTdxgh","deploymentId":"dpl_5joLUXmnJgwqjrHAS4dxZrQTdxgh","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-B3yYlvdS.js","lightbox-handle-r17bVUz3.js"]}