Para configurar sua própria API no Cherry Studio, acesse 設定 → 模型供應商 → 新增供應商: informe a chave de API, preencha uma URL raiz em cada um dos campos OpenAI e Anthropic de “端點設定”, salve, clique em “同步模型” para importar os modelos e use “檢查” para confirmar.Este artigo é baseado na v2.1.4, publicada em 30 de setembro de 2026, e todos os nomes de menu seguem o texto original da interface do Cherry Studio em chinês tradicional. A v2 mudou bastante a tela de adição de provedores; os tutoriais da era da v1, que diziam “類型選 OpenAI”, não correspondem mais à interface atual.
Esta página refere-se à versão para desktop de CherryHQ/cherry-studio (AGPL-3.0, compatível com Windows, macOS e Linux). Em 1º de outubro de 2026, a verificação mostrou que o repositório não estava arquivado e que a versão mais recente era a v2.1.4. O app de mesmo nome na App Store é um produto não relacionado de outro desenvolvedor. Além disso, a documentação oficial do Cherry Studio está em chinês simplificado; ao mudar a interface para chinês tradicional, “提供商/服務商” aparece como “供應商”. Não confunda os nomes ao comparar com a documentação.
Configuração passo a passo
設定 → 模型供應商 → 新增供應商
（對話框標題：新增自訂供應商）
供應商名稱 Kunavo
API 金鑰 sk-kn-...
端點設定
OpenAI Chat Completions https://api.kunavo.com/v1
Anthropic Messages https://api.kunavo.com
更多選項
OpenAI Responses https://api.kunavo.com/v1 （選填）
影像產生基礎 URL https://api.kunavo.com/v1 （選填）
Google Gemini 留空
→ 儲存 → 在模型清單按「同步模型」→ 加入要用的模型 → 「檢查」- Abra Configurações → Provedores de modelos e clique em Adicionar provedor. A caixa de diálogo exibida se chama “Adicionar provedor personalizado”. Para serviços do tipo Coding Plan, várias contas ou separação por projeto, use “Começar com um padrão (opcional)” na parte superior para criar a partir de um padrão existente.
- Preencha Nome do provedor e Chave de API.
- Configurações de endpoint já inclui, por padrão, os campos OpenAI Chat Completions e Anthropic Messages; configure pelo menos um endpoint de texto. Se preencher ambos, os modelos também poderão ser selecionados para Agents além do chat e para recursos que usam o formato Anthropic.
- Expanda Mais opções; também há OpenAI Responses, Google Gemini, URL base para geração de imagens e URL base para edição de imagens. Deixe em branco o que não for usar.
- Depois de salvar, confirme que este provedor está Ativado. A documentação oficial informa que modelos de um provedor configurado, mas não ativado, não aparecem no menu — essa é a causa mais comum de a “chave não funcionar”.
- Na lista de modelos, clique em Sincronizar modelos, adicione os modelos que deseja usar e clique em Verificar para testar um deles.
Como preencher o endereço: informe apenas a URL raiz
De acordo com o código-fonte da v2.1.4, cada campo recebe uma URL raiz: quando não há um segmento de versão, o sistema acrescenta automaticamente /v1 (e não o acrescenta se já existir), seguido do caminho fixo do campo. Abaixo de cada campo aparece “Caminho da solicitação”; esse é o endereço final enviado.
| Campo | Caminho conectado pelo Cherry Studio | Kunavo |
|---|---|---|
| OpenAI Chat Completions | /chat/completions | Compatível |
| Anthropic Messages | /messages | Compatível |
| OpenAI Responses (Mais opções) | /responses | Compatível |
| URL base para geração de imagens (Mais opções) | /images/generations | Compatível |
| URL base para edição de imagens (Mais opções) | /images/edits | Compatível |
| Google Gemini (Mais opções) | /models/{model}:generateContent | Não compatível; deixe em branco |
Dois erros comuns: primeiro, colar uma URL completa que contenha /chat/completions ou /messages, duplicando o caminho e retornando 404; segundo, adicionar # ao final. A interface explica claramente: “Adicione # ao final para desativar o acréscimo automático da versão da API.” Em endpoints padrão, se você o adicionar, /v1 desaparece.
Configure corretamente e reduza a conta
Além do chat, o Cherry Studio também chama modelos em segundo plano. O modelo rápido, segundo a descrição da interface, é “usado para tarefas simples, como nomear conversas e extrair palavras-chave para pesquisas”, e a instrução diz “selecione um modelo leve e evite modelos de raciocínio”. Coloque aqui um modelo barato para não fazer o modelo caro executar uma rodada a cada conversa. O modelo de tradução também é configurado separadamente. Ao selecionar vários modelos para fazer uma pergunta ao mesmo tempo, cada modelo recebe uma solicitação e gera uma cobrança. O valor exibido nas estatísticas de uso do app é um valor estimado calculado com base nos preços públicos; ao usar uma rota com desconto, ele ficará maior que o real. Altere os preços unitários nas configurações do modelo para os valores que você realmente paga. Para mais detalhes, consulte o artigo em inglês Cherry Studio API cost.
Observações sobre usar a Kunavo e pagamentos em Taiwan
- Escopo da verificação: as configurações acima foram compiladas a partir do código-fonte e da documentação oficial do Cherry Studio; a Kunavo não conectou efetivamente o Cherry Studio ao seu próprio endpoint para executar testes. Preserve a rota que já funciona e teste esta também.
- Apenas chat e imagens: a Kunavo não possui modelos de embeddings; a busca vetorial da base de conhecimento deve usar outro provedor ou um modelo de embeddings local. A documentação oficial informa que, sem um modelo de embeddings, a base de conhecimento continua funcionando com busca por palavras-chave BM25.
- Ferramentas MCP: as ferramentas adicionadas em Configurações → Servidores MCP só podem ser chamadas por modelos compatíveis com chamadas de ferramentas; os modelos Claude e GPT adicionados acima são compatíveis.
- Pagamento: recarga pré-paga, cobrança por token, sem mensalidade. Recarga mínima de US$ 10, checkout pela Stripe, com cartões disponíveis em Taiwan (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay e Link; JKoPay e LINE Pay não estão na lista de opções disponíveis. Consulte as informações de cobrança; depois de se preparar, você pode criar uma conta e gerar uma chave. A página de configurações em inglês é o guia de integração do Cherry Studio.
Perguntas frequentes
Como configurar sua própria API no Cherry Studio?
Acesse Configurações → Provedores de modelos → Adicionar provedor, abra a caixa de diálogo “Adicionar provedor personalizado”, preencha o nome do provedor e a chave de API e, nos campos OpenAI Chat Completions e Anthropic Messages das configurações de endpoint, informe a URL raiz e salve. Em seguida, na lista de modelos, clique em “Sincronizar modelos” para importá-los, adicione os modelos que deseja usar e use “Verificar” para confirmar que um deles funciona. O provedor precisa estar ativado; caso contrário, o modelo não aparecerá no menu.
É necessário adicionar /v1 ao endereço da API do Cherry Studio?
Pode adicionar ou não. O código-fonte da v2.1.4 acrescenta automaticamente a versão (/v1) após a URL raiz informada e não a duplica se ela já estiver presente; depois acrescenta o caminho próprio do campo (OpenAI: /chat/completions; Anthropic: /messages). O que deve ser evitado é colar uma URL completa que contenha /chat/completions, pois o caminho será duplicado e retornará 404. O # no final serve para “desativar o acréscimo automático da versão da API”; não o adicione a endpoints padrão. Abaixo de cada campo aparece “Caminho da solicitação”; confira-o antes de salvar para saber qual será a URL final.
O que fazer quando “Sincronizar modelos” não encontra nenhum modelo?
Esse botão usa o endereço e a chave informados para solicitar a lista de modelos do provedor (/v1/models). Se a lista estiver vazia, geralmente há um problema no endereço ou na chave, não no Cherry Studio. Primeiro, confirme que você não colou uma URL completa e que não há # no final; depois, teste o mesmo endereço e a mesma chave com curl: uma resposta JSON indica que o problema está no app; uma resposta 401 indica que a chave está incorreta.
O Cherry Studio pode ser configurado para chinês tradicional?
Sim. A interface do Cherry Studio inclui 13 idiomas, incluindo chinês tradicional (zh-TW); basta trocar nas opções de idioma das configurações. Observe que a interface tradicional chama o provedor de “供應商”, enquanto a documentação oficial e a interface simplificada usam “提供商” ou “服務商”. Os nomes serão diferentes ao comparar os tutoriais, mas referem-se à mesma coisa.
O Cherry Studio é pago?
A versão para desktop (edição comunitária) é um software de código aberto sob AGPL-3.0 e é gratuita. O que você paga são as tarifas de uso dos modelos do provedor configurado. O Cherry Studio Enterprise é um produto comercial com preço separado; o CherryAI integrado é gratuito, mas o conjunto de modelos e os limites não são divulgados.
Verificado em 1º de outubro de 2026: a API do GitHub (CherryHQ/cherry-studio, v2.1.4), as strings da interface em chinês tradicional da v2.1.4 (zh-tw.json), o código-fonte da tela de adição de provedores e a documentação oficial do Cherry Studio. A Kunavo não executou seu próprio endpoint no Cherry Studio na prática.