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.
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.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.
Iniciar Cherry Studio
Abra o Cherry Studio uma vez após a instalação e confirme que a janela principal inicia normalmente.
Adicionar Provider
Abrir configurações
Inicie o Cherry Studio e abra Settings. A entrada pode ficar no canto inferior esquerdo ou na barra lateral.
Abrir serviços de modelo
Encontre Model services, Model providers, Provider ou uma página de configuração de API.
Adicionar Provider
Clique em Add, New provider ou ação semelhante. Use
4096bytes como nome do Provider.Preencher campos de conexão
| Campo no Cherry Studio | Valor |
|---|---|
Name, Provider name | 4096bytes |
API Key, Key | A API Key criada no painel do 4096bytes. |
API address, API Host, Base URL | https://api.4096bytes.com. |
API type, Compatible type | Compatível com OpenAI. |
Model, Model name | O nome do modelo exibido no painel. |
/v1/chat/completions, /v1/responses ou outro caminho completo.
Adicionar modelos
Versões do Cherry Studio tratam listas de modelos de formas diferentes. Algumas buscam modelos automaticamente; outras exigem nomes manuais.Tentar buscar modelos
Se a página tiver Fetch models, Refresh model list ou Check, execute primeiro.
Adicionar modelo manualmente
Se a lista de modelos estiver vazia, clique em Add model ou Custom model e informe o nome exibido no painel.
Testar conexão
Depois de salvar, crie uma conversa no Cherry Studio e selecione um modelo do Provider 4096bytes. Use um prompt curto: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
Teste de conexão falhou
Teste de conexão falhou
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.Lista de modelos vazia
Lista de modelos vazia
Se Cherry Studio não buscar modelos automaticamente, adicione manualmente o nome exibido no painel. Salve o Provider e reabra a conversa.
Falha de autenticação
Falha de autenticação
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.
model not found
model not found
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.
A conversa usa outro Provider
A conversa usa outro Provider
Verifique o seletor de modelo da conversa atual. Cherry Studio pode manter o último modelo usado, então mude manualmente para o Provider 4096bytes.
Requisições lentas ou interrompidas
Requisições lentas ou interrompidas
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.