Cherry Studio: use Claude e GPT com uma API personalizada

O Cherry Studio é um cliente de IA para desktop, gratuito, para Windows, macOS e Linux. Ele oferece uma janela de chat com assistentes, seletor de modelos, bases de conhecimento, ferramentas MCP e respostas de vários modelos lado a lado. O Cherry Studio não tem modelos próprios: você conecta provedores com chaves de API, e cada mensagem é cobrada por esse provedor.

A APIVAI é um desses provedores. Uma única chave da APIVAI funciona com modelos Claude e GPT, no formato OpenAI e no formato Anthropic, com cobrança por token abaixo dos preços oficiais. Assim, uma só entrada de provedor no Cherry Studio coloca Claude Sonnet 4.6, Claude Opus 5.5 e GPT-5.5 na mesma lista de modelos.

O Cherry Studio oferece duas formas claras de conectar a APIVAI:

Escolha o provedor personalizado se quiser Claude e GPT lado a lado com uma chave; é o que serve para a maioria. Escolha o provedor Anthropic se você usa só Claude e prefere o formato nativo, por exemplo para recursos do Cherry Studio que exigem um endpoint com protocolo Anthropic. Dá para configurar os dois com a mesma chave.

Nas versões atuais, o diálogo + Add Provider mostra campos de endpoint separados (OpenAI e Anthropic por padrão, e outros em More Settings). A documentação do Cherry Studio não explica como um modelo escolhe entre dois endpoints do mesmo provedor, então este guia preenche ali apenas o endpoint OpenAI e usa o provedor Anthropic integrado para o caminho nativo do Claude. Versões antigas pedem um Provider Type; escolha OpenAI.

1. Cadastre-se em apivai.com com seu e-mail.
2. Recarregue o saldo a partir de $10 com cartão, cripto, Alipay ou WeChat Pay. Não há assinatura nem teste grátis; você paga só pelos tokens que usar.
3. Abra o Painel, crie uma chave e copie. Você pode definir um limite de orçamento próprio para ela.

1. Clique em Settings (o ícone de engrenagem na barra lateral esquerda).
2. Abra a aba Model Services.
3. Clique em + Add Provider, abaixo da lista de provedores.
4. Preencha o diálogo conforme a tabela e clique em Add.

Sobre o /v1: o Cherry Studio espera o endereço base e acrescenta a versão e o caminho sozinho, então https://api.apivai.com vira https://api.apivai.com/v1/chat/completions. As versões atuais também aceitam https://api.apivai.com/v1 sem duplicar, mas nunca cole o endereço completo com /v1/chat/completions. Um # no final faz o Cherry Studio usar o endereço exatamente como digitado; com a APIVAI isso não é necessário.

1. Abra na lista o provedor APIVAI que você acabou de criar.
2. Clique em Get model list. O Cherry Studio busca os modelos que sua chave pode usar; clique no + ao lado de cada um que quiser. Só os modelos adicionados aparecem nos seletores.
3. Se preferir digitar, clique em + e informe um ID como claude-sonnet-4-6, claude-haiku-4-5 ou gpt-5.5.

A lista de modelos muda com o tempo, então pegue os IDs em Get model list ou na página de preços, e não em capturas de tela antigas.

1. Clique em Test (Check em algumas versões) e escolha um modelo. Uma mensagem de sucesso indica que a chave e o endereço estão corretos.
2. Ative o provedor pelo botão no canto superior direito da página dele. Um provedor ativo aparece com um ponto verde na lista.
3. Abra um chat, escolha o modelo no menu suspenso no topo e envie uma mensagem.

Em Model Services, abra Anthropic, cole sua chave da APIVAI em API Key e troque API Address de https://api.anthropic.com para https://api.apivai.com. Não acrescente /v1; o endereço tem o mesmo formato do da Anthropic. Depois clique em Get model list, adicione os modelos Claude desejados e ative o provedor. Modelos GPT não funcionam aqui; eles usam o provedor personalizado do passo 2. A página Claude API proxy explica o formato Anthropic em mais detalhes.

Preços por 1M de tokens em 2026-10-07. Todos os modelos estão na página de preços.

Um arranjo prático: um assistente padrão barato com Claude Haiku 4.5 ou GPT-6 Luna, um principal com Claude Sonnet 4.6 e o Claude Opus 5.5 só para as perguntas que precisam dele. O Cherry Studio permite enviar a mesma pergunta para vários modelos de uma vez, um jeito barato de compará-los nas suas próprias tarefas.

O Cherry Studio é gratuito; você paga só pelos tokens. Cada mensagem reenvia a conversa até ali, então em chats longos cada turno custa mais. O raciocínio (thinking) vem ativado por padrão e seus tokens são cobrados como saída.

• Chat do dia a dia: considere um turno de cerca de 3.000 tokens de entrada (sua mensagem mais o histórico recente) e 800 de saída. Com o Claude Sonnet 4.6, um turno custa $0.0073 ($0.021 no preço oficial). Com 40 turnos por dia durante 30 dias (1.200 turnos), são $8.76 por mês, contra $25.20. O mesmo mês custa $2.93 com o Claude Haiku 4.5 e $0.126 com o GPT-6 Luna.
• Trabalho com um documento longo: você cola um relatório de cerca de 30.000 tokens e faz 10 perguntas de acompanhamento; cada uma reenvia uns 31.000 tokens de entrada e retorna 1.500 de saída. Com o Claude Sonnet 4.6, a sessão custa $0.401 ($1.16 no preço oficial).

Para gastar menos, abra um tópico novo quando mudar de assunto e dê ao Cherry Studio uma chave própria com limite de orçamento. O Painel mostra cada requisição com tokens e custo. Para uma comparação de preços mais ampla, veja Preços da API do Claude comparados.

O chat funciona totalmente pela APIVAI, mas as bases de conhecimento precisam de um modelo de embeddings para indexar seus arquivos, e a APIVAI não oferece embeddings. Para usar uma base de conhecimento, configure no Cherry Studio um provedor de embeddings separado; o assistente que responde pode continuar sendo um modelo Claude ou GPT da APIVAI. Modelos de geração de imagens também não estão disponíveis na APIVAI.

• 401 ou "invalid API key": a chave foi copiada incompleta, foi excluída ou atingiu o limite de orçamento. Copie de novo no Painel e confira o saldo.
• 404: o endereço está errado. No provedor personalizado use https://api.apivai.com, sem /chat/completions e sem # no final. No provedor Anthropic use https://api.apivai.com sem /v1.
• Modelo não encontrado: o ID precisa ser exato, por exemplo claude-sonnet-4-6, e não um nome de exibição. Use Get model list para ver o que sua chave acessa. Modelos GPT falham no provedor Anthropic; adicione-os ao provedor personalizado.
• O modelo não aparece no seletor do chat: o provedor está desativado, ou você buscou a lista mas não clicou no + ao lado do modelo.
• Respostas vazias ou cortadas: tokens de raciocínio contam no limite de saída. Em Edit Assistant → aba Model, desative Enable message length limit (MaxToken) ou defina 4096 ou mais.
• A resposta chega de uma vez ou o streaming para: confira o botão Streaming output (Stream) na mesma aba e as configurações de proxy nas opções de rede do Cherry Studio.
• 429: o limite padrão é de 60 requisições por minuto por chave. Comparar vários modelos de uma vez consome várias requisições; aguarde um pouco ou peça ao suporte um limite maior.

A documentação traz todos os endpoints e códigos de erro.

Para usar Claude e GPT juntos, um provedor personalizado com o endpoint OpenAI. O provedor Anthropic integrado só se você quiser o Claude no formato nativo da Anthropic.

Não precisa. Informe https://api.apivai.com; o Cherry Studio acrescenta /v1 e o caminho da requisição. Nunca informe o endereço completo com /v1/chat/completions.

Sim. Uma chave da APIVAI vale para todos os modelos da página de preços e nos dois formatos. A mesma chave funciona no Chatbox e em outras ferramentas compatíveis com OpenAI.

Não. O conteúdo de requisições e respostas não é registrado; só ficam dados de uso como modelo, tokens e custo, para a cobrança. Seu histórico fica no Cherry Studio, no seu computador.

Não. A cobrança é pré-paga e por uso, com recargas a partir de $10 e sem assinatura.

Crie uma conta, recarregue a partir de $10 e cole sua chave no Cherry Studio.