> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leapx-hub.com/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 **LeapX API**, you can easily use various mainstream AI models in Cherry Studio.

## Quick Integration

### 1. Get API Key

Visit [LeapX API](https://leapx-hub.com) to get your API key.

### 2. Configuration

1. Open Cherry Studio
2. Click the settings icon on the left
3. Select "Model Service"
4. Fill in:
   * API URL: `https://api.leapx-hub.com`
   * API Key: Your key from LeapX API console
5. Click "➕ Add" to save

<Warning>
  API URL must be `https://api.leapx-hub.com`
</Warning>

### 3. Add Models

1. Search for target model (e.g. `gemini-2.5-pro-preview-06-05`)
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

## Supported Models

### Latest Recommended

| Series          | Model ID                     | Features                                         |
| --------------- | ---------------------------- | ------------------------------------------------ |
| Gemini 2.5      | `gemini-2.5-pro`             | Google's latest, strong multimodal               |
| ChatGPT 5 Chat  | `gpt-5-chat-latest`          | OpenAI's latest, balanced performance            |
| Claude Thinking | `claude-sonnet-4-5-20250929` | Shows reasoning process (use thinking parameter) |
| Claude 4 Sonnet | `claude-sonnet-4-20250518`   | Anthropic's latest, long text processing         |

### Classic Stable

| Series          | Model ID                            | Use Case                     |
| --------------- | ----------------------------------- | ---------------------------- |
| Claude Sonnet   | `claude-sonnet-4-20250514`          | Daily chat, content creation |
| Claude Thinking | `claude-sonnet-4-20250514-thinking` | Complex reasoning            |

### Selection Guide

* **Multimodal**: `Gemini 2.5 Pro`
* **Daily Chat**: `ChatGPT 4o Latest`
* **Long Text**: `Claude Sonnet 4.5`
* **Complex Reasoning**: Models with `thinking` suffix

## Advanced Features

### Image Support

For vision-enabled models (e.g. `GPT-4V`):

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">
    * Verify API key is correct
    * Confirm API URL is `https://api.leapx-hub.com`
    * Check 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>

## Tips

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