> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio

> Cherry Studio Client Integration Guide

## Introduction

Cherry Studio is a powerful AI chat client that supports multiple large language models. With MixRoute API, you can easily use various mainstream AI models in Cherry Studio.

## Quick Integration

### 1. Get API Key

Visit [MixRoute](https://api.mixroute.ai/) to get your API key.

### 2. Configuration

<Steps>
  <Step title="Open App">
    Open Cherry Studio application
  </Step>

  <Step title="Settings">
    Click the settings icon on the left to enter settings page
  </Step>

  <Step title="Select Service">
    Select "Model Service" option

    <Frame>
      <img src="https://mintcdn.com/personal-a5418d9f/AGrfXdfEdIEy9oaC/images/cherry-studio-0.png?fit=max&auto=format&n=AGrfXdfEdIEy9oaC&q=85&s=5088eac704cf97323961ed8d5a9e30aa" alt="Cherry Studio 0" width="1207" height="1342" data-path="images/cherry-studio-0.png" />
    </Frame>
  </Step>

  <Step title="Fill Config">
    <Tabs>
      <Tab title="Traditional API Node">
        ```text theme={null}
        # Select the corresponding provider, using OpenAI's GPT series as an example
        API Key : <you api key>
        API Host : https://api.mixroute.ai/v1
        Models: gpt-5.5
        ```
      </Tab>

      <Tab title="Smart Routing Node">
        <Tip>
          [Smart Routing](https://console.mixroute.ai/smart-route) is an intelligent model routing capability that automatically distributes requests to the most suitable model based on task complexity, reducing API costs while enhancing efficiency.

          See [here](/en/smart-routing) for constraints and usage guide.
        </Tip>

        ```text theme={null}
        # Using Smart Routing
        API Key : <you smart routing key>
        API Host : https://api.mixroute.ai/v1
        Models: auto
        ```
      </Tab>
    </Tabs>

    <Frame>
      <img src="https://mintcdn.com/personal-a5418d9f/AGrfXdfEdIEy9oaC/images/cherry-guide-3.png?fit=max&auto=format&n=AGrfXdfEdIEy9oaC&q=85&s=15605e9014e174dfc90096f6a9e5f530" alt="Cherry Guide 3" width="974" height="926" data-path="images/cherry-guide-3.png" />
    </Frame>
  </Step>

  <Step title="Save">
    Click "➕ Add" to save
  </Step>
</Steps>

<Warning>
  API URL must be `https://api.mixroute.ai`
</Warning>

### 3. Add Models

1. Search for target model in the model search box (e.g., `gpt-5.5`). If using Smart Routing mode, use `auto` directly for task routing.
2. Click the icon next to model name to configure
3. Enable/disable model variants as needed
4. Use right-side buttons for detailed configuration

## Advanced Features

### Image Support

If using a model that supports images (such as `gpt-5.5` or `gemini-3.5-flash`):

1. Enable "Images" in settings
2. Select a vision-capable model
3. Upload images directly in chat

### Streaming Output

Cherry Studio supports streaming output by default for smoother conversations.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection Failed">
    * Check if API key is correct
    * Confirm API URL is `https://api.mixroute.ai`
    * Verify network connection
  </Accordion>

  <Accordion title="Model Unavailable">
    * Confirm sufficient account balance
    * Check if model is in subscription plan
    * Try switching to another model
  </Accordion>
</AccordionGroup>

## Model Recommendations

<CardGroup cols={2}>
  <Card title="Daily Chat" icon="message">
    Recommended: `gpt-5.4-mini` (lightweight) or `gpt-5.5` (high quality)
  </Card>

  <Card title="Multimodal Tasks" icon="images">
    Recommended: `gemini-3.5-flash` or `gpt-5.5`
  </Card>

  <Card title="Long Context" icon="file-lines">
    Recommended: `claude-sonnet-5` or `gemini-3.5-flash` (1M context)
  </Card>

  <Card title="Complex Reasoning" icon="brain">
    Recommended: `claude-opus-4-8` or `grok-4.20-beta-0309-reasoning`
  </Card>
</CardGroup>

## Tips

1. **Choose wisely**: Match models to task requirements
2. **Stay updated**: Follow new model releases
3. **Monitor usage**: Check usage via Mixroute Api console