Prerequisites
Before you begin, please ensure:-
Cherry Studio is installed
Download and install the version suitable for your operating system from Cherry Studio Official Website -
APIMart API Key obtained
Log in to APIMart Console to get your API key (starts withsk-)
Tip: If you don’t have an APIMart account yet, please register at APIMart and obtain an API key first.
Step 1: Open Cherry Studio Settings
After launching Cherry Studio, navigate to the settings page:- Click the ⚙️ Settings icon (gear icon) in the top right corner
- Or use keyboard shortcuts:
- Windows/Linux:
Ctrl + , - macOS:
Cmd + ,
- Windows/Linux:

Step 2: Add APIMart Model Platform
2.1 Access Model Service Management
In the settings page:- Find the Model Service option in the left menu
- Click to enter model service management page

2.2 Add APIMart Provider
- At the bottom of the model service page, click the ”+ Add” button

-
In the “Add Provider” dialog, fill in:
- Provider Name:
APIMart(customizable) - Provider Type: Select
OpenAI
- Provider Name:
- Click the “Confirm” button
2.3 Configure APIMart API Information
After adding the provider, fill in the API information in the right configuration area:| Field | Value |
|---|---|
| API Key | Your APIMart API key (sk-xxxxxxxxxxxx) |
| API URL | https://api.apimart.ai |
Important:
- API URL must be
https://api.apimart.ai(do not include/v1or other paths) - API Key must be obtained from APIMart console and start with
sk- - After filling in, you can click the “Test” button to test the connection

Step 3: Add and Manage Models
3.1 Open Model Management
After configuring the APIMart provider:- Ensure the APIMart provider switch in the top right is ON (green)
- In the right configuration area, find the “Models” section
- Click the “Manage” button to open the model selection window

3.2 Add Desired Models
In the model selection window:- Use the search box to find specific models
- Use the category tabs at the top to filter: All, Reasoning, Vision, Web, Free, Embedding, Rerank, Tool
- Find the models you want and click the + button on the right to add:
gpt-4o/chatgpt-4o- OpenAI GPT-4o modelgpt-4o-mini- Faster and more economical versionclaude-3series - Claude 3 models (with multiple variants)claude_code_sonnet-4- Claude Code Sonnet 4claude_code_haiku-4- Claude Code Haiku 4gemini-2.0-flash-exp- Google Gemini 2.0 Flash

- After adding all desired models, close the model selection window
Step 4: Start Chatting
After configuration, you can start using it:- Return to the main interface, click the ”+” at the top or select an existing chat
- At the top of the chat page, click the model selector
- Select a model under the APIMart provider
- Start chatting with AI!


FAQ
Q1: Cannot connect to APIMart service?
Solution:-
Check Base URL:
- Ensure Base URL is
https://api.apimart.ai - Do not add
/v1suffix
- Ensure Base URL is
-
Verify API Key:
- Confirm API Key is correct and starts with
sk- - Check if the key is valid in APIMart Console
- Confirm API Key is correct and starts with
-
Check Network Connection:
- Ensure you can access
https://api.apimart.ai - You may need to configure a proxy if in China
- Ensure you can access
Q2: Model list is empty or cannot refresh?
Solution:-
Manually Add Models:
- If auto-refresh fails, you can manually add common models
- In model management, manually enter model names (e.g.,
gpt-4o)
-
Check API Permissions:
- Confirm your API Key has permission to access the model list
- Contact APIMart support to check account status
Q3: Error messages during conversation?
Common errors and solutions:| Error Message | Cause | Solution |
|---|---|---|
401 Unauthorized | Invalid or expired API Key | Re-obtain API Key and update configuration |
429 Too Many Requests | Request rate limit exceeded | Wait a moment and retry |
500 Internal Server Error | Temporary server issue | Wait a few minutes and retry |
insufficient_quota | Insufficient account balance | Top up in the console |
Q4: How to view API usage and costs?
Log in to APIMart Console to view:- 📊 API call statistics
- 💰 Cost details
- 📈 Usage trend charts
Features
Using Cherry Studio + APIMart, you can:- 💬 Multi-model Conversations - Use different AI models in the same interface
- 🖼️ Image Understanding - Multi-modal conversations with image input support
- 📝 Context Management - Intelligent management of conversation history and context
- 🎨 Custom Prompts - Create and manage prompt templates
- 📊 Export Conversations - Export conversation records to Markdown and other formats
- 🔄 Model Comparison - Use multiple models simultaneously and compare outputs
Support & Help
If you encounter any issues:- 📚 APIMart Documentation
- 💬 Discord Community
- 🐦 Twitter @APIMart_
- 📧 Technical Support: zhihong@apimart.ai
Start Using APIMart
Register for APIMart now, get your API key, and start your AI journey!