Skip to main content
Cherry Studio é útil para gerenciar vários Providers de modelos em um cliente. Adicione o 4096bytes como Provider compatível com OpenAI e selecione seus modelos nas conversas.

​
Pré-requisitos

  • Você concluiu Criar conta.
  • Você concluiu Obter API Key.
  • Cherry Studio está instalado e a página de configurações abre normalmente.
  • Você tem API Key, Base URL e nome do modelo do 4096bytes.
Crie uma API Key dedicada para Cherry Studio, como cherry-studio-home ou cherry-studio-work.

​
Instalar

Se Cherry Studio não estiver instalado, abra a página de download do Cherry Studio e escolha o pacote para seu sistema.
1

Baixar o pacote

Escolha Windows, macOS ou Linux pela página oficial. No Windows, pode ser necessário escolher entre instalador e versão portátil. No macOS, escolha Intel ou Apple Silicon corretamente.
2

Iniciar Cherry Studio

Abra o Cherry Studio uma vez após a instalação e confirme que a janela principal inicia normalmente.
3

Abrir configurações

Abra Settings e encontre páginas de serviço de modelos, Provider ou configuração de API.

​
Adicionar Provider

1

Abrir configurações

Inicie o Cherry Studio e abra Settings. A entrada pode ficar no canto inferior esquerdo ou na barra lateral.
2

Abrir serviços de modelo

Encontre Model services, Model providers, Provider ou uma página de configuração de API.
3

Adicionar Provider

Clique em Add, New provider ou ação semelhante. Use 4096bytes como nome do Provider.
4

Escolher tipo compatível

Escolha OpenAI, OpenAI Compatible, Custom OpenAI ou opção semelhante.

​
Preencher campos de conexão

Use apenas o Base URL raiz. Não adicione /v1/chat/completions, /v1/responses ou outro caminho completo.
A API Key fica salva nas configurações locais do Cherry Studio. Não configure uma chave pessoal em computadores compartilhados e não compartilhe capturas que exponham a chave.

​
Adicionar modelos

Versões do Cherry Studio tratam listas de modelos de formas diferentes. Algumas buscam modelos automaticamente; outras exigem nomes manuais.
1

Tentar buscar modelos

Se a página tiver Fetch models, Refresh model list ou Check, execute primeiro.
2

Adicionar modelo manualmente

Se a lista de modelos estiver vazia, clique em Add model ou Custom model e informe o nome exibido no painel.
3

Salvar Provider

Ative o Provider e salve API Key, Base URL e lista de modelos.
O nome do modelo deve corresponder exatamente ao painel.

​
Testar conexão

Depois de salvar, crie uma conversa no Cherry Studio e selecione um modelo do Provider 4096bytes. Use um prompt curto:
Se o modelo responder, Cherry Studio consegue enviar requisições pelo 4096bytes.

​
Sugestões

  • Use uma API Key dedicada para Cherry Studio.
  • Se houver vários Providers, confira o modelo selecionado antes de enviar.
  • Se Cherry Studio oferecer grupos ou modelos padrão, defina seu modelo 4096bytes comum como padrão.
  • Evite chaves pessoais em dispositivos compartilhados pela equipe. Se precisar compartilhar, use uma chave separada com limite de cota.

​
Diagnóstico

Confirme que o tipo do Provider é compatível com OpenAI e verifique API Key, Base URL e nome do modelo. Use https://api.4096bytes.com e não informe caminho completo de endpoint.
Se Cherry Studio não buscar modelos automaticamente, adicione manualmente o nome exibido no painel. Salve o Provider e reabra a conversa.
Verifique se a API Key está completa e foi copiada sem espaços ou quebras de linha extras. Confirme que a chave não foi excluída, expirou ou ultrapassou a cota.
Copie novamente o nome do modelo no painel. Ele deve corresponder exatamente e não deve vir de outra página de cliente ou captura antiga.
Verifique o seletor de modelo da conversa atual. Cherry Studio pode manter o último modelo usado, então mude manualmente para o Provider 4096bytes.
Comece com um prompt curto. Contextos longos, anexos, redes com proxy e requisições concorrentes podem afetar o tempo de resposta. Consulte os logs do Cherry Studio se necessário.