Integração com o Cherry Studio

Documentação mantida por 1ZheAI. Fontes e correções.

Encontrou um erro? Contate o suporte com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

O Cherry Studio é um cliente de chat de IA para desktop onde você pode adicionar a 1折AI como um provedor personalizado.

Importação em um clique

No console, em Chaves da API → Ferramentas → Cherry Studio, selecione o protocolo Anthropic ou OpenAI e clique em Abrir Cherry Studio. Após confirmar a importação no aplicativo, busque os modelos, ative o provedor e faça um teste. Se já existir uma configuração com o mesmo nome, verifique o aviso de substituição. O link de importação contém a chave completa — não o encaminhe.

O navegador não pode confirmar se o aplicativo está instalado. Se ele não abrir, instale e inicie o cliente uma vez primeiro, ou use as etapas manuais abaixo. O formato do protocolo foi verificado em relação à implementação oficial, mas a inferência real ainda precisa ser verificada em relação à sua versão e modelo específicos.

Configuração

1. Adicionar provedor

   Configurações (ícone de engrenagem) → Serviços de modelo → + Adicionar provedor na parte inferior da lista.

2. Preencher informações

   Campo	O que inserir
   Nome do provedor	1折AI
   Chave da API	sk-你的Key
   Endpoint	Selecione Anthropic (recomendado) ou OpenAI
   Endereço da API	https://1zheai.com

   Insira apenas a URL base no campo Endereço da API; o Cherry Studio anexará automaticamente /v1/... com base no protocolo selecionado. Não cole caminhos completos como /v1/messages ou /v1/chat/completions, e não adicione # no final (um # final significa que nenhum caminho será anexado automaticamente).

3. Adicionar modelo

   Clique em Obter lista de modelos e adicione os modelos que deseja usar da lista retornada; ou clique em + para inserir manualmente um ID de modelo, como claude-sonnet-5-5. Apenas os modelos adicionados à lista aparecerão no seletor de modelos no chat.

4. Ativar e testar

   Ative a chave de ativação no canto superior direito da página do provedor, volte para a interface de chat e envie uma mensagem usando um modelo sob a 1折AI.

Escolhendo o endpoint Anthropic ou OpenAI

Endpoint	Melhor para
Anthropic	Usar capacidades nativas do Claude, como pensamento estendido; consulte a versão atual para as restrições de protocolo do Agente
OpenAI	Estar acostumado ao formato OpenAI, ou gerenciar junto com outros serviços compatíveis com OpenAI

Ambos os endpoints usam a mesma chave da API e o mesmo conjunto de IDs de modelos.

Perguntas frequentes

Falha ao obter lista de modelos?

Primeiro verifique se a chave da API tem espaços extras; depois confirme se o endereço da API é https://1zheai.com sem nenhum caminho extra escrito. Se você não conseguir buscar a lista, isso não afeta o uso — inserir manualmente um ID de modelo também funciona.

Conversa retorna 404?

O endereço da API foi inserido como um caminho completo, ou # foi adicionado no final. Altere de volta para a URL base https://1zheai.com.