Início → Guias → Cherry Studio com API personalizada: endereço, modelos, Claude e imagens

Cherry Studio com API personalizada: endereço, modelos, Claude e imagens

Adicionar um provedor no Cherry Studio leva menos de um minuto. O único campo que costuma dar errado é o endereço da API, porque o Cherry acrescenta /v1 sozinho. E quando você começa a anexar prints, importa saber quais modelos enxergam a imagem — testamos sete.

Adicionando o provedor

Abra Configurações → Provedores de modelos e clique em Adicionar. Dê um nome (por exemplo APICLAN) e escolha o tipo OpenAI.
Cole sua chave de API do console.
Informe https://apiclan.us como endereço da API.
Clique em Verificar e escolha qualquer modelo para confirmar a chave.

Você digita	O Cherry Studio chama
`https://apiclan.us`	`https://apiclan.us/v1/chat/completions` ✓
`https://apiclan.us/v1/`	`https://apiclan.us/v1/chat/completions` ✓
`https://apiclan.us/v1`	`https://apiclan.us/v1/v1/chat/completions` ✗ 404

O Cherry Studio acrescenta /v1/chat/completions ao endereço, a menos que ele termine em /. Então https://apiclan.us e https://apiclan.us/v1/ funcionam, mas https://apiclan.us/v1 sem a barra final vira /v1/v1 e retorna 404.

Adicionando modelos

Clique em Gerenciar abaixo do provedor. O Cherry Studio busca a lista em /v1/models, que só retorna os modelos do grupo da sua chave. Em 12 de outubro de 2026 eram:

Grupo GPT: gpt-5.6-sol, gpt-5.6-terra, gpt-6-astra, gpt-6-sol, gpt-6.1-sol
Grupo DeepSeek: deepseek-v4-flash, deepseek-v4-pro, deepseek-v4.1-flash (mais versões com data)

Clique em + ao lado dos que quiser. Se faltar um modelo, sua chave pertence a outro grupo — cada chave deste gateway fica ligada a um único grupo.

Adicionando o Claude

Adicione um segundo provedor do tipo Anthropic, com o mesmo endereço https://apiclan.us e uma chave criada num grupo Claude. Depois adicione claude-opus-5-5 ou claude-fable-5-1. Um provedor por grupo evita misturar chaves: GPT, DeepSeek e Claude ficam cada um na sua entrada.

Quais modelos leem as imagens que você anexa

Enviamos a cada modelo a mesma imagem pequena de uma só cor, pela requisição no estilo OpenAI que o Cherry Studio usa, e perguntamos a cor. Repetimos com uma segunda cor para que um chute certo não passasse.

Modelo	Lê imagens	Tempo de resposta
`claude-opus-5-5`	✓	3.1 s
`claude-fable-5-1`	✓	3.3 s
`deepseek-v4.1-flash`	✓	2.3–3.1 s
`gpt-6-astra`	✓	6.6 s
`gpt-5.6-sol`	✓	7.3 s
`gpt-6.1-sol`	✓	24–25 s
`deepseek-v4-pro`	✗	—

O deepseek-v4-pro não aceita imagens: respondeu “white” para uma imagem verde e na outra vez não devolveu nada, sem erro. Para prints, use um modelo marcado. O gpt-6.1-sol lê imagens corretamente, mas levou cerca de 24 segundos, contra 2,6 segundos até o primeiro token numa requisição só de texto. Se o Cherry Studio não mostrar o botão de imagem para um modelo, abra as configurações dele e marque Visão. Teste de 12 de outubro de 2026.

Erros comuns

401 → a chave está errada ou não combina com o provedor (uma chave GPT no provedor Anthropic, por exemplo).
404 → o endereço termina em /v1 sem barra. Use https://apiclan.us.
model_not_found (is not supported by any configured account in this group) → o modelo não está no grupo da sua chave. Adicione por Gerenciar em vez de digitar.
A resposta ignora sua imagem → o modelo não lê imagens. Troque por um marcado na tabela.

Configurando ferramentas de programação? Cline com API personalizada · Codex com API personalizada.

Comece a usar

Sem assinatura, sem mínimo mensal, sem conversa com vendedor. Recarregue com USDT e gaste o que usar — 1 USDT dá 2 créditos de saldo de API.

Leia o início rápido de 30 segundos

Idioma: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Os preços desta página são preenchidos automaticamente com dados reais de cobrança. Condições de terceiros são citadas da documentação deles.