> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agipower.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Cherry studio
# Guide to Using Cherry Studio via AGIPower
Cherry Studio is an elegant cross-platform AI desktop client that supports multiple mainstream large language model services. Through integration with AGIPower, you can access the extensive model catalog aggregated on the AGIPower platform within Cherry Studio, enjoying more flexible model selection and better pricing.
AGIPower fully supports the OpenAI Chat Completions protocol and can be seamlessly integrated into clients like Cherry Studio that support custom OpenAI-compatible endpoints. Simply add AGIPower as a model provider to use all models that support the OpenAI protocol.
Note that the base\_url for the OpenAI protocol is `https://api.agipower.ai/v1/`.
## Configuration
### Step 1: Download and Install Cherry Studio
Go to the [Cherry Studio official site](https://www.cherry-ai.com) to download the version for your operating system and complete the installation.
### Step 2: Add the AGIPower Model Provider
1. Open Cherry Studio and go to the **Settings → Model Provider** page
2. Click the **Add** button to add a new model provider
3. Fill in the following details in the configuration dialog:
* **Provider Name**: `AGIPower` (or any preferred name)
* **Provider Type**: select `OpenAI`
* **API Key**: enter your AGIPower API Key (format `sk-xxx`)
* **API Host**: `https://api.agipower.ai/v1/`
Make sure to replace `sk-xxx` with your actual AGIPower API Key. You can obtain your API Key from the [AGIPower Console](https://agipower.ai/settings/keys).
* **Provider Name**: Customizable; using `AGIPower` is recommended for clarity
* **Provider Type**: Must select `OpenAI`, as AGIPower supports the OpenAI Chat Completions protocol
* **API Key**: Your AGIPower API Key for authentication and billing
* **API Host**: AGIPower’s OpenAI-compatible endpoint address; must end with `/`
### Step 3: Fetch the Available Model List
After configuration, click the **Manager** button. Cherry Studio will automatically fetch the list of all models that support the OpenAI Chat Completions protocol from AGIPower.
Cherry Studio will automatically discover all available models via AGIPower’s `/v1/models` API endpoint—no manual addition required.
### Step 4: Add the Models You Need
From the fetched model list, select the models you want to use and add them to your model library.
We recommend adding models across different capability and price tiers to suit various use cases:
* **High-performance models**: `openai/gpt-5`, `anthropic/claude-sonnet-4.5`
* **Balanced models**: `google/gemini-2.5-pro`, `x-ai/grok-4-fast`
* **Cost-effective models**: `deepseek/deepseek-chat`, `qwen/qwen3-coder-plus`
### Step 5: Start a Conversation
Go to the chat interface, select any model under the AGIPower provider, and start using it.
You can switch between models at any time during a conversation. Cherry Studio preserves the chat history, making it easy to compare outputs from different models.
## Supported Models
AGIPower offers a large and constantly growing set of models that support the OpenAI Chat Completions protocol. You can view the full list in the following ways:
* Visit the [AGIPower Model List](https://agipower.ai/models) and filter by "OpenAI API Compatible"
* Or visit the detail page of a specific model to check its protocol support
Visit the [AGIPower Model List](https://agipower.ai/models) to learn about all available models and their details, including pricing, context length, feature capabilities, and more.
## Usage Experience
Once configured, you can seamlessly use a variety of AGIPower models within Cherry Studio:
* Unified chat interface without switching between different clients
* Real-time model switching to compare output quality
* Complete chat history management and export
* Advanced features such as file uploads and multimodal input
Feature support varies across models, such as visual understanding and function calling. Refer to the detail page of each model for its capabilities.
## Troubleshooting
### Common Issues
#### API Key Error
**Issue**: Invalid or unauthorized API Key when adding a provider
**Solutions**:
* Check if the API Key was copied correctly; avoid extra spaces or line breaks
* Confirm the API Key format starts with `sk-`
* Verify the API Key is activated and the account has sufficient balance
* Log in to the [AGIPower Console](https://agipower.ai/settings/keys) to check the API Key status
#### Unable to Fetch Model List
**Issue**: Unable to retrieve the model list after clicking the Manager button
**Solutions**:
* Check if the API Host is correctly set to `https://api.agipower.ai/v1/` (note the trailing slash)
* Verify network connectivity and try accessing `https://agipower.ai` in your browser
* Ensure firewall or proxy settings are not blocking access to the AGIPower servers
* Check whether your Cherry Studio version is up to date; older versions may have compatibility issues
#### Model Invocation Failed
**Issue**: Errors returned after selecting a model and sending a message
**Solutions**:
* Confirm the selected model is still available on the AGIPower platform (some models may be retired)
* Check whether your account balance is sufficient
* Verify that the model supports your request parameters (e.g., temperature, max\_tokens, etc.)
* Review the detailed error message and adjust request parameters accordingly
* Try switching to another model to determine if the issue is specific to a particular model
#### Slow Response
**Issue**: Model responses are slow or lagging
**Solutions**:
* Check your network quality and diagnose with a speed test tool
* Try switching to a model labeled "fast" (e.g., `x-ai/grok-4-fast`)
* Reduce the token count per request by lowering the `max_tokens` parameter
* Avoid peak usage periods or select models with lower load
* If the issue persists, contact AGIPower technical support for assistance
If you encounter any issues during use or have suggestions and feedback, feel free to reach us via:
* **Official Website**: [https://agipower.ai](https://agipower.ai)
* **Technical Support Email**: [support@agipower.ai](mailto:support@agipower.ai)
* **Business Contact Email**: [support@agipower.ai](mailto:support@agipower.ai)
* **Twitter**: [@AGIPowerAI](https://twitter.com/AGIPowerAI)
* **Discord Community**: [http://discord.gg/vHZZzj84Bm](http://discord.gg/vHZZzj84Bm)
For more contact options and details, please visit our [Contact Us page](/en/help/contact).