Pular para o conteúdo principal
A API Key é a credencial que permite que um cliente chame o 4096bytes. Você precisa de uma antes de conectar Codex, Claude Code, Cursor, Cherry Studio ou outro gerenciador de clientes. Crie API Keys separadas para clientes ou dispositivos diferentes. Por exemplo, uma chave para Codex, uma para Cursor e uma para Cherry Studio. Isso facilita rastrear o uso e permite desativar apenas a chave afetada se um cliente expuser a credencial.
Uma API Key é uma credencial da conta. Se ela for exposta, outras pessoas podem consumir seu saldo. Exclua chaves vazadas imediatamente e crie uma nova.

​
Abrir a página de API Keys

1

Entrar no painel

Acesse https://dash.4096bytes.com/login e entre na sua conta 4096bytes.
2

Abrir API Keys

No menu lateral, abra API Keys.
3

Revisar chaves existentes

A página lista as API Keys criadas na conta atual. Você pode atualizar a lista ou criar uma nova chave.
Página de API Keys Se já houver chaves antigas, não reutilize a mesma chave em todos os clientes. Prefira nomes como claude-code-mac, codex-work ou cursor-desktop.

​
Criar uma chave

Clique em Create key. O painel abre uma janela. No mínimo, preencha Name e escolha um Group. Mantenha os outros controles desligados, a menos que você precise da restrição. Janela de criação de chave
1

Informar um nome

Use um nome claro, como macbook-codex, cursor-work ou cherry-studio-home.
2

Escolher um grupo

Selecione a rota de modelo, plano ou grupo que esta chave deve usar. Taxas, modelos disponíveis e regras de cota podem mudar por grupo. Use o que o painel mostrar.
3

Manter chave personalizada desligada

Deixe Custom key desativado, a menos que exista um motivo específico para fixar o texto da chave. Chaves geradas automaticamente são mais seguras.
4

Ativar restrição de IP só quando necessário

Use IP restriction apenas para servidores ou IPs de saída fixos. Isso normalmente não é adequado para notebooks ou redes móveis.
5

Definir limite de cota se necessário

Quota limit controla o valor máximo em USD que esta chave pode consumir. 0 significa sem limite. Use um limite pequeno para testes temporários, membros da equipe ou dispositivos pouco usados.
6

Definir limite de taxa se necessário

Ative Rate limit apenas quando precisar reduzir concorrência ou evitar consumo anormal de um cliente.
7

Definir validade se necessário

Use Key validity period para chaves temporárias de teste. Ferramentas locais de uso contínuo podem ter validade maior.
8

Criar e copiar

Clique em Create. Copie a API Key imediatamente e salve-a em local seguro.
Normalmente a API Key completa é exibida apenas uma vez. Se você esquecer de salvá-la, exclua a chave e crie outra.

​
Exemplos de nomes

CenárioNome de exemplo
Codex CLIcodex-macbook
Claude Codeclaude-code-work
Cursorcursor-desktop
Cherry Studiocherry-studio-home

​
Armazenar e usar a chave

Salve a chave em um gerenciador de senhas, chaveiro do sistema ou variável de ambiente local. Não coloque a chave em repositórios públicos, capturas de tela, conversas ou documentos compartilhados. Para Claude Code, veja se a lista de API Keys tem a ação Use key. O painel pode mostrar variáveis de ambiente ou trechos de configuração para essa chave. Para ferramentas com suporte a importação, veja se o painel oferece importação com um clique. Os nomes e recursos dependem da versão atual do painel.

​
Testar se a chave funciona

Depois de criar a chave, prefira o teste interno do cliente. Você também pode testar o endpoint de modelos compatível com OpenAI.

​
macOS ou Linux

curl "https://api.4096bytes.com/v1/models" \
  -H "Authorization: Bearer YOUR_4096BYTES_API_KEY"

​
Windows PowerShell

Invoke-RestMethod `
  -Uri "https://api.4096bytes.com/v1/models" `
  -Headers @{ Authorization = "Bearer YOUR_4096BYTES_API_KEY" }
Substitua YOUR_4096BYTES_API_KEY pela API Key recém-criada. Se a resposta retornar uma lista de modelos, a API Key e o Base URL estão basicamente funcionando. Se o teste falhar, verifique primeiro:
ItemO que verificar
Chave completaNão deixe faltar caracteres e não copie espaços ou quebras de linha extras.
Grupo disponívelO grupo da chave deve estar ativo e conter o modelo chamado.
Saldo ou cotaSaldo da conta, cota de assinatura e cota da chave podem afetar requisições.
Base URL corretoCopie o Base URL exibido no painel. Não tente adivinhar o caminho.

​
Manutenção

Remova chaves não usadas regularmente. Desative ou exclua chaves antigas, sem finalidade clara, sem uso ou suspeitas de vazamento. Depois de excluir uma chave, qualquer cliente que a use falhará imediatamente. Crie uma nova chave e atualize a configuração do cliente.

​
Próximo passo

Escolha um cliente: CC Switch, Codex, Claude Code, Cursor ou Cherry Studio.