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

# FAQ

> Resolva erros comuns ao conectar clientes ao 4096bytes

Esta página cobre problemas comuns ao conectar o 4096bytes a clientes. Comece verificando três valores: API Key, Base URL e nome do modelo.

## Parâmetros de conexão

<AccordionGroup>
  <Accordion title="Qual Base URL devo usar?">
    Clientes compatíveis com OpenAI normalmente usam `https://api.4096bytes.com`. Se o painel mostrar um endereço específico para o cliente na janela **Use key**, use o valor exibido ali.
  </Accordion>

  <Accordion title="Preciso adicionar /v1, /chat/completions ou /messages?">
    Não adicione caminhos de API manualmente. A maioria dos clientes precisa apenas do Base URL raiz, e o próprio cliente adiciona o caminho da requisição. Claude Code, Codex e Cursor podem usar formatos diferentes, então siga a página correspondente.
  </Accordion>

  <Accordion title="Onde encontro o nome do modelo?">
    Copie o nome do modelo no painel. Preserve letras, números, hifens e sufixos de versão exatamente como aparecem. Não copie nomes de modelos de capturas antigas ou de outros usuários.
  </Accordion>

  <Accordion title="Posso copiar os valores de exemplo diretamente?">
    `YOUR_4096BYTES_API_KEY` e `PASTE_MODEL_NAME_FROM_DASHBOARD` são placeholders. Copie a API Key real e o nome do modelo no painel. O valor fixo `https://api.4096bytes.com` é o endpoint compatível com OpenAI atual.
  </Accordion>
</AccordionGroup>

## Gerenciamento de API Key

<AccordionGroup>
  <Accordion title="Vários clientes podem compartilhar a mesma API Key?">
    Tecnicamente sim, mas não é recomendado. Use chaves separadas para Codex, Claude Code, Cursor e Cherry Studio. Isso facilita rastrear uso e desativar apenas uma chave se houver vazamento.
  </Accordion>

  <Accordion title="Posso ver a API Key completa novamente depois da criação?">
    Normalmente não. Copie e salve a chave imediatamente após a criação. Se você esqueceu de salvá-la, exclua a chave antiga e crie uma nova.
  </Accordion>

  <Accordion title="O que fazer se minha API Key vazou?">
    Exclua a chave vazada no painel imediatamente. Depois crie uma nova chave e atualize o cliente afetado. Não continue usando uma chave que apareceu em capturas, logs, conversas ou repositórios públicos.
  </Accordion>

  <Accordion title="Devo definir limite de cota?">
    Para uso pessoal contínuo, você pode começar sem limite. Para testes temporários, membros da equipe, dispositivos compartilhados ou clientes pouco usados, defina um limite pequeno para evitar consumo inesperado.
  </Accordion>
</AccordionGroup>

## Erros

<AccordionGroup>
  <Accordion title="401 ou falha de autenticação">
    A API Key pode estar inválida, excluída, incompleta ou copiada com caracteres extras. Copie novamente e verifique espaços, quebras de linha, aspas inteligentes ou caracteres ocultos.
  </Accordion>

  <Accordion title="403 ou permissão negada">
    Verifique o grupo da chave, a disponibilidade do modelo e o status da conta. O grupo precisa estar ativo e incluir o modelo chamado.
  </Accordion>

  <Accordion title="404 ou endpoint inexistente">
    O Base URL pode estar errado, ou o cliente pode estar montando o caminho incorretamente. Use `https://api.4096bytes.com` e remova qualquer caminho completo adicionado manualmente.
  </Accordion>

  <Accordion title="429 ou muitas requisições">
    Frequência, concorrência, saldo ou limites da chave podem ter sido atingidos. Reduza a concorrência, tente novamente depois e verifique saldo, cota e limites no painel.
  </Accordion>

  <Accordion title="model not found">
    Copie novamente o nome do modelo no painel. Ele precisa corresponder exatamente, incluindo maiúsculas, números, hifens e sufixos.
  </Accordion>

  <Accordion title="unsupported protocol ou invalid URL">
    O formato do Base URL está incompleto. Ele deve começar com `https://`. Não informe `api.4096bytes.com`, espaços extras, aspas ou quebras de linha.
  </Accordion>
</AccordionGroup>

## Comportamento dos clientes

<AccordionGroup>
  <Accordion title="O cliente ainda falha depois de salvar as configurações">
    Reinicie o cliente primeiro. Depois verifique se há múltiplos locais de configuração, Providers ou listas de modelos. Confirme que o modelo ativo vem do 4096bytes.
  </Accordion>

  <Accordion title="Por que o Cursor ainda usa modelos oficiais?">
    API Keys personalizadas no Cursor podem não afetar todos os recursos internos. Selecione o modelo 4096bytes no Chat ou Agent. Tab completion, indexação e tarefas em segundo plano ainda podem usar serviços do Cursor.
  </Accordion>

  <Accordion title="Por que o Claude Code ignora o Base URL?">
    Claude Code lê variáveis de ambiente relacionadas à Anthropic. Siga [Claude Code](/pt-BR/clients/claude-code) e use `ANTHROPIC_BASE_URL` com a variável de autenticação correspondente.
  </Accordion>

  <Accordion title="Codex ainda usa o modelo antigo">
    Coloque a nova configuração no início de `~/.codex/config.toml` e confirme que `model_provider` aponta para o Provider do 4096bytes. Reinicie o terminal depois de salvar.
  </Accordion>

  <Accordion title="Cherry Studio não mostra modelos">
    Se o cliente não buscar a lista de modelos automaticamente, adicione manualmente o nome do modelo exibido no painel e selecione-o novamente no chat atual.
  </Accordion>
</AccordionGroup>

## Ordem recomendada

1. Copie a API Key novamente.
2. Confirme que o Base URL é `https://api.4096bytes.com` ou o valor específico do cliente exibido no painel.
3. Copie o nome do modelo novamente.
4. Confirme que o tipo de Provider corresponde à página do cliente.
5. Reinicie o cliente ou terminal.
6. Verifique saldo, cota, validade da chave, limites de taxa e status do grupo.
7. Entre em contato com o suporte enviando dados ocultados.

Se você ainda não concluiu a configuração básica, comece por [Obter API Key](/pt-BR/quickstart/get-api-key) e depois abra a página do cliente correspondente.