Adicione todo modelo do catálogo ao Cherry Studio como um provider.

Resposta rápida: um provider em Model Services.

Clique no ícone de engrenagem na navegação esquerda do Cherry Studio, abra a aba Model Services, e clique no botão Add sob a lista de providers. Dê ao provider um nome reconhecível (APIsRouter) e escolha OpenAI como o tipo de provider, depois salve. Agora selecione o novo provider na lista e configure-o: ative seu interruptor de habilitação, cole sua chave no campo de chave de API, e defina o endereço de API como https://api.apisrouter.com. Preste atenção no formato: o padrão documentado do Cherry Studio é receber o endereço raiz e anexar /v1/chat/completions por conta própria, então você insere o host sem /v1. Depois adicione modelos com o botão Add na seção de modelo, um id exato do catálogo por entrada (claude-sonnet-4-6, deepseek-v4-flash, glm-5.2), e pressione o botão Check ao lado da chave para rodar uma validação ao vivo contra um modelo selecionado.

Nome do provider:  APIsRouter
Tipo de provider:  OpenAI

depois, na página do provider:
API key:           sk-YOUR-APISROUTER-KEY
API address:       https://api.apisrouter.com
                   (o Cherry anexa /v1/chat/completions)
Models → + Add:    claude-sonnet-4-6, deepseek-v4-flash, glm-5.2
Check → escolha um modelo → sucesso

Como o Cherry Studio compõe a URL de requisição.

O Cherry Studio (CherryHQ no GitHub, cerca de 49 mil estrelas) é um cliente de desktop de origem chinesa para Windows, macOS e Linux, conhecido por vir com presets para centenas de providers e assistentes. Qualquer coisa fora da lista de presets entra pelo fluxo de provider personalizado acima, e a parte que vale a pena entender é o campo de endereço de API. O padrão documentado: você fornece o endereço raiz, e o Cherry Studio concatena a rota OpenAI a ele, então https://api.apisrouter.com vira https://api.apisrouter.com/v1/chat/completions na prática. Se um provider usa um caminho não padrão, terminar o endereço com # desabilita a concatenação por completo e o endereço é usado exatamente como digitado, que é a saída de emergência documentada. O comportamento de concatenação em torno de barras finais mudou entre versões, então se as requisições derem 404, leia a URL final no erro em vez de adivinhar; a forma de endereço raiz mais anexação automática é a configuração estável para um gateway /v1 padrão. Uma vez configurado, toda conversa envia chat completions padrão com o id de modelo que você adicionou como uma string simples. Fornecedores não importam para o formato de conexão, o que é o que permite que uma entrada de provider carregue ids chineses e ocidentais juntos.

Detalhes que valem a pena: rotação de múltiplas chaves e gestão de modelo.

O campo de chave de API aceita mais de uma chave: separe as chaves com vírgulas comuns e o Cherry Studio rotaciona entre elas de cima a baixo por requisição, um recurso documentado de balanceamento de carga. Com um gateway que mede por chave, isso também funciona como atribuição: uma chave para trabalho, uma para pessoal, rotação desligada listando só uma. As entradas de modelo são manuais e isso é um recurso. O Cherry Studio mostra exatamente o que você adiciona, então o seletor fica curado em vez de afogado em um catálogo buscado automaticamente. Cada entrada recebe o id como a string de conexão; o botão Manage edita ou remove entradas depois. Agrupe ids relacionados com nomenclatura consistente e o seletor lê como um menu: tier rápido (deepseek-v4-flash, claude-haiku-4-5-20251001), força regional (glm-5.2, qwen3.7-plus, kimi-k2.6), ponta (claude-sonnet-4-6). O botão Check valida o par de chave e endereço contra um modelo que você seleciona, e é a forma mais rápida de confirmar o provider antes de conversas reais. Uma verificação falha com uma chave correta quase sempre significa que o campo de endereço carrega um /v1 sobrando que duplicou o caminho.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# adicione esses ids exatamente na lista de modelo do provider

Escolhendo modelos para um cavalo de batalha no desktop.

Uma chave significa que comparações são trocas de seletor. Rode a mesma semana de trabalho em dois ids candidatos e deixe o gasto por modelo no console da APIsRouter arbitrar contra sua própria leitura da qualidade da saída.

• Chat do dia a dia e reescritas rápidas vivem no tier rápido: deepseek-v4-flash e claude-haiku-4-5-20251001 mantêm a janela sempre aberta parecendo grátis.
• Trabalho em chinês é onde os ids regionais ganham suas linhas: glm-5.2 e qwen3.7-plus para rascunhos e documentos, kimi-k2.6 para leitura de contexto longo.
• claude-sonnet-4-6 leva as conversas que você encaminha sem editar: análise cuidadosa, prosa voltada ao cliente, código que você pretende publicar.
• Os assistentes do Cherry Studio podem fixar seu próprio modelo por papel, então um assistente de tradução em glm-5.2 e um assistente de codificação em claude-sonnet-4-6 coexistem atrás de um provider.
• Adicione linhas deliberadamente; um seletor curado de seis modelos é usado, enquanto um catálogo colado inteiro é apenas rolado.

Pague pelo uso · abaixo do preço oficial

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Modos de falha específicos do Cherry Studio.

O caminho duplicado é o relato mais comum: colar https://api.apisrouter.com/v1 em um campo que anexa /v1/chat/completions produz URLs /v1/v1 que dão 404. Insira o endereço raiz e deixe o cliente construir a rota. Se você precisar fixar uma URL exata, a forma com # no final existe para isso. Uma verificação falha com uma chave boa geralmente é o formato de endereço acima; uma verificação falha com um endereço limpo é a chave, e observe que várias chaves precisam ser separadas por vírgulas comuns, já que caracteres de largura total colados de métodos de entrada chineses quebram a lista silenciosamente. Modelos dando erro individualmente enquanto outros funcionam é um problema de grafia de id; as entradas são texto livre e a listagem /v1/models é a fonte autoritativa. E lembre-se que as configurações são por máquina: um provider configurado no seu desktop não existe no seu laptop até você repetir a configuração de dois minutos ou usar os próprios recursos de backup do Cherry Studio. Nota de deriva de versão: o Cherry Studio lança frequentemente e os rótulos de configuração se movem (Model Services também apareceu como Model Provider em algumas versões); o fluxo de adicionar provider, escolher tipo OpenAI, chave, endereço, modelos permaneceu estável.

Quem roteia o Cherry Studio por um gateway.

• Usuários bilíngues de desktop misturando GLM, Qwen, Kimi e DeepSeek com Claude e GPT em um seletor, um saldo, sem contas por fornecedor.
• Usuários na Ásia que querem ids Claude e GPT em um saldo pré-pago sem um cartão ocidental, ao lado dos modelos regionais que já usam.
• Power users rodando assistentes do Cherry Studio por papel que querem cada assistente fixado no fornecedor certo sem gerenciar cinco chaves.
• Pessoas que já roteiam outras ferramentas por um gateway e querem o cliente de desktop na mesma chave e log de uso.
• Qualquer um comparando modelos regionais e ocidentais em trabalho diário real em vez de benchmarks, onde cada candidato é uma linha de modelo.

Verifique o endpoint e depure a primeira conversa.

Faça curl na listagem de modelos primeiro e copie os ids que você planeja adicionar; depois rode uma chat completion contra seu cavalo de batalha diário pretendido. Com os dois passando, tudo que resta está na página do provider. Dentro do Cherry Studio, rode o Check antes de conversar. Falhas de autenticação são o campo de chave ou seus separadores de vírgula. 404s são o formato de endereço, leia a URL composta no erro e conte os segmentos /v1. Erros de não encontrado em um modelo específico são grafia de id naquela linha. Assim que as conversas fluem, o console da APIsRouter mostra modelo, contagens de token e gasto por requisição. Um cliente de desktop usado ao longo de um dia de trabalho gera um fluxo constante de pequenas requisições, e a visão de uso por chave transforma esse fluxo em números por modelo, por dia, com ids chineses e ocidentais na mesma página.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Perguntas frequentes