Use A2Agent Models with Cherry Studio

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.

​

Prerequisites

• Cherry Studio installed
• An A2Agent API key — sign up at a2agent.me/register to get one
• API request URL: https://api.a2agent.me

​

Setup

​

1. Add a Provider

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.

​

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.