Documentação
Cherry Studio
O provedor personalizado do Cherry Studio usa um endereço raiz separado para cada protocolo — OpenAI, Anthropic e Gemini. Cole a chave e os endereços raiz, pressione Sincronizar modelos e o catálogo preencherá o seletor automaticamente.
Settings → Model Services → um provedor personalizado: cole a chave e o endereço da API, clique em Get Model List e todo o catálogo preencherá o seletor.
设置 → 模型服务 → 添加 → 添加自定义提供商 (Settings → Model Services → Add → Add Custom Provider)
提供商名称 / Provider name Kunavo
API 密钥 / API Key sk-kn-...
端点设置 / Endpoint settings
OpenAI https://api.kunavo.com/v1
Anthropic https://api.kunavo.com
→ 同步模型 (Sync Models), then add the models you want
→ 检测 (Test) to confirmGET /v1/models usando a raiz informada no campo correspondente e a chave fornecida; por isso, também é a maneira mais rápida de verificar se essa combinação está correta — uma lista vazia quase sempre indica um problema na chave ou no endereço, não no provedor.https://api.kunavo.com e https://api.kunavo.com/v1 resolvem corretamente no campo OpenAI) e sempre acrescenta a rota correspondente ao campo. Cole a URL de endpoint completa — já terminada em /chat/completions ou /messages — e essa rota será acrescentada uma segunda vez, causando um erro 404 na solicitação.sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Cherry Studio.Passo a passo
- Crie uma chave em
/app/keyse copie-a — ela é exibida uma única vez. - Abra 设置 → 模型服务 (Configurações → Serviços de modelos) e 添加自定义提供商 (Adicionar provedor personalizado).
- Preencha API 密钥 (a chave) e o campo de endpoint OpenAI (
https://api.kunavo.com/v1). - Preencha também o campo Anthropic (
https://api.kunavo.com) — ele fica abaixo do OpenAI em 端点设置 (Configurações de endpoint). O Cherry Agent e qualquer modelo encaminhado pelo protocolo Anthropic Messages leem especificamente este campo, não o OpenAI. Os outros tipos de endpoint ficam em 更多设置 (Mais opções). - Salve e pressione 同步模型 na lista de modelos do provedor; depois, adicione os modelos de chat desejados e use 检测 para verificar um deles de ponta a ponta.
- Atribua modelos a cada assistente, em vez de defini-los globalmente — o Cherry Studio mantém um modelo por assistente, permitindo que uma opção padrão econômica e uma especialista mais cara coexistam.
Verificado em Documentação de provedores do Cherry Studio em 1 de outubro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.
Verifique antes de depurar o cliente
Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em Cherry Studio.
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."Qual ID de modelo inserir no campo
Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.
| ID do modelo | Entrada / saída da Kunavo | Onde se encaixa em Cherry Studio |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | o assistente do dia a dia |
claude-opus-5 | $3.50 / $17.50 | um assistente reservado para problemas difíceis |
claude-haiku-4-5 | $0.70 / $3.50 | tradução, resumo e tudo que exige alto volume |
gpt-5-6-terra | $0.70 / $4.20 | documentos longos e contextos extensos colados |
Perguntas frequentes
Como adiciono um provedor de API personalizado ao Cherry Studio?
Abra Configurações → Serviços de modelos (设置 → 模型服务) e Adicionar provedor personalizado (添加自定义提供商). Ele aceita um endereço raiz separado para cada tipo de endpoint — OpenAI e Anthropic aparecem por padrão; OpenAI Responses, Gemini e os endpoints de imagem ficam em Mais opções (更多设置) — além de uma única chave de API. Informe a chave e as raízes dos endpoints necessários, pressione Sincronizar modelos (同步模型) para importar o catálogo, adicione os modelos desejados e use Testar (检测) para confirmar que um deles funciona.
Por que Sincronizar modelos não retorna nada no Cherry Studio?
Esse botão chama a rota /v1/models do campo OpenAI usando a chave informada, então um resultado vazio aponta para o endereço desse campo ou para a chave, não para o Cherry Studio. Cada campo recebe um endereço raiz — o Cherry Studio acrescenta a versão e a rota por conta própria —, então confira se você não colou uma URL de endpoint completa (já terminada em /chat/completions) e depois teste a mesma combinação com curl: uma resposta JSON indica que o problema está no aplicativo; 401 indica a chave.
O que significa um # no final do campo de endpoint do Cherry Studio?
A documentação do próprio Cherry Studio descreve esse recurso como uma forma de fixar o campo em um caminho específico para endpoints cuja rota não segue o formato padrão. Os endpoints OpenAI e Anthropic da Kunavo seguem o padrão, então você não precisa disso — informe o endereço raiz, com ou sem seu próprio /v1, e deixe o Cherry Studio acrescentar o restante.
O Cherry Studio pode usar modelos Claude sem uma conta Anthropic?
Sim, quando um gateway os oferece — informe o endereço da Kunavo especificamente no campo Anthropic, não no OpenAI, pois o Cherry Agent e qualquer modelo encaminhado pelo protocolo Anthropic Messages leem esse campo. O Cherry Studio envia o ID do modelo ao endpoint indicado na entrada do provedor, então um ID Claude é resolvido ali, e a única credencial que o Cherry Studio mantém é a chave desse endpoint.