> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio

> Adicione o 4096bytes como Provider no Cherry Studio

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](/pt-BR/quickstart/create-account).
* Você concluiu [Obter API Key](/pt-BR/quickstart/get-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](https://docs.cherry-ai.com/docs/en-us/cherry-studio/download) e escolha o pacote para seu sistema.

<Steps>
  <Step title="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.
  </Step>

  <Step title="Iniciar Cherry Studio">
    Abra o Cherry Studio uma vez após a instalação e confirme que a janela principal inicia normalmente.
  </Step>

  <Step title="Abrir configurações">
    Abra **Settings** e encontre páginas de serviço de modelos, Provider ou configuração de API.
  </Step>
</Steps>

## Adicionar Provider

<Steps>
  <Step title="Abrir configurações">
    Inicie o Cherry Studio e abra **Settings**. A entrada pode ficar no canto inferior esquerdo ou na barra lateral.
  </Step>

  <Step title="Abrir serviços de modelo">
    Encontre **Model services**, **Model providers**, **Provider** ou uma página de configuração de API.
  </Step>

  <Step title="Adicionar Provider">
    Clique em **Add**, **New provider** ou ação semelhante. Use `4096bytes` como nome do Provider.
  </Step>

  <Step title="Escolher tipo compatível">
    Escolha **OpenAI**, **OpenAI Compatible**, **Custom OpenAI** ou opção semelhante.
  </Step>
</Steps>

## 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.      |

Use apenas o Base URL raiz. Não adicione `/v1/chat/completions`, `/v1/responses` ou outro caminho completo.

<Warning>
  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.
</Warning>

## Adicionar modelos

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

<Steps>
  <Step title="Tentar buscar modelos">
    Se a página tiver **Fetch models**, **Refresh model list** ou **Check**, execute primeiro.
  </Step>

  <Step title="Adicionar modelo manualmente">
    Se a lista de modelos estiver vazia, clique em **Add model** ou **Custom model** e informe o nome exibido no painel.
  </Step>

  <Step title="Salvar Provider">
    Ative o Provider e salve API Key, Base URL e lista de modelos.
  </Step>
</Steps>

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:

```text theme={null}
Diga em uma frase o nome do modelo que você está usando agora.
```

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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>