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

# Cherry Studio

> Integre o AIHubMix no cliente desktop Cherry Studio para usar Claude, GPT e Gemini, e habilite o cache de prompt do Claude para reduzir custos e ganhar tempo.

[**Download Cherry Studio AI**](https://easys.run/cherry-studio/)

## General Usage

1. Abra **Settings** a partir do bottom-left corner of the app.

   <img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/en/CS1.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=df290eeaf273e02bc81b1219ce2affbd" alt="Abrir as Configurações no Cherry Studio" width="1356" height="835" data-path="public/en/CS1.png" />
2. Na seção **Model Providers**, selecione **AiHubMix** and clique no button no top-right corner to enable it.
3. No campo **chave de API**, enter [the Key from this site](https://aihubmix.com/token).\
   Leave the **API Base URL** unchanged.\
   **Note: If the connection check fails, try disabling your VPN.**

   <img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/en/CS2.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=d8940f62c356ed2ab9c5a5893286cbe9" alt="Selecionar o provedor AiHubMix e inserir a chave de API" width="1358" height="837" data-path="public/en/CS2.png" />
4. Clique **Add Model** at the bottom.\
   For the **Model ID**, go to the settings page on this website, selecione the model you want to use, and copy-paste its name.

   <img src="https://mintcdn.com/aihubmix/njYPCqTk0m3HBNaY/public/en/CS3.png?fit=max&auto=format&n=njYPCqTk0m3HBNaY&q=85&s=4108a6e7b9eb612f83456fa1039aa7b7" alt="Adicionar modelo colando o ID do modelo desejado" width="1358" height="835" data-path="public/en/CS3.png" />

## Perguntas Frequentes

### The model indicates it cannot see images

Some newer models may not recognize images after they are uploaded.\
In this case, você precisa manually enable the **Image** option on the settings page.

<img src="https://mintcdn.com/aihubmix/AfNgblL-wCNs82Ww/public/en/CS4.png?fit=max&auto=format&n=AfNgblL-wCNs82Ww&q=85&s=b6e45ddcbc89e351852a86badb39168b" alt="Marcar a opção de imagem nas configurações para o modelo reconhecer imagens" width="483" height="281" data-path="public/en/CS4.png" />

<Tip>
  The `gemini-3-pro-image-preview` model cannot return images when **streaming output** is enabled.\
  Please disable streaming output when using this model.

  <img src="https://mintcdn.com/aihubmix/oCJ4o1SNFsJN6z-I/public/en/CS5.png?fit=max&auto=format&n=oCJ4o1SNFsJN6z-I&q=85&s=debdd87af29a3477568a471d20b51646" alt="Desativar a saída em streaming para retornar imagens corretamente" width="2144" height="1554" data-path="public/en/CS5.png" />
</Tip>

### Calling Claude models returns `AI_APICallError`

Check whether the request URL shown no error message is\
`https://aihubmix.com/anthropic/v1/messages`.

If so, go to **Settings** and change the **Anthropic API Host** to: `https://aihubmix.com`

<img src="https://mintcdn.com/aihubmix/G8QySdgS7UmbtB3g/public/en/CS6.png?fit=max&auto=format&n=G8QySdgS7UmbtB3g&q=85&s=8e67b948fc475bdcebbb3174a79d94e5" alt="Alterar o Anthropic API Host para aihubmix.com" width="1284" height="994" data-path="public/en/CS6.png" />

## Habilitar o cache de prompt do Claude

Nas "API Settings" do provedor Aihubmix (engrenagem à direita do nome do provedor), configure "Cache Token Threshold", "Cache System Message" e "Cache Last N Messages" para injetar automaticamente o `cache_control` nos modelos Claude. O significado de cada item e os pontos-chave para acertar o cache estão em [Cache de Prompt do Claude](../api/Claude-Cache).

***

Última atualização: 2026-06-01