Obter e gerenciar chaves de API

Como criar chaves de API que começam com sk- no console da 1zheai, além de armazená-las, rotacioná-las e conter danos em caso de vazamento.

Uma chave de API (API key) corresponde a uma permissão de chamada, e o custo é debitado do saldo da sua conta. Esta página explica como criar, onde armazenar e o que fazer em caso de incidente.

Criar uma chave de API

Entrar no console
Abra 1zheai.com/console.

Novo

No menu lateral, clique em “Chave de API” e depois em “Criar chave de API” no canto superior direito. Preencha um nome que deixe claro o propósito, como claude-code-macbook, ci-staging; os demais campos podem ficar com os valores padrão e mesmo assim funcionarão. Clique em “Salvar alterações”.

Itens configuráveis no formulário:

Campo do formulário	Padrão	Descrição
Nome	Vazio	Diferencia as chaves de API nos registros de chamadas
Data de expiração	Nunca expira	Opções de 1 hora, 1 dia, 1 mês, ou data e hora específicas
Quantidade	1	Cria várias de uma vez; um sufixo aleatório é adicionado automaticamente ao nome
Alternador “Cota ilimitada”	Ativado	Ao desativar, aparece “Cota (USD)”; esta chave de API poderá gastar no máximo esse valor em dólares
Restrição de modelos (em “Configurações avançadas”)	Vazio, significa que todos os modelos podem ser usados	Após selecionar modelos, esta chave de API só poderá chamar esses modelos
Lista branca de IPs (em “Configurações avançadas”)	Vazio, significa sem restrição	Permite chamadas apenas dos IPs ou faixas CIDR listados

Copiar e salvar
As chaves de API começam com sk-. Após copiar, guarde-as em um gerenciador de senhas ou variável de ambiente; não as cole em conversas, capturas de tela ou repositórios de código.

Uma chave de API por ferramenta

Recomenda-se criar uma chave de API separada para cada ferramenta e cada máquina. Os três benefícios:

Os registros de chamadas são diferenciados por chave de API, permitindo ver de relance quanto cada ferramenta gastou.
Se uma chave de API for vazada, basta excluir apenas aquela, sem afetar as demais ferramentas.
Cada pessoa da equipe é responsável pela própria chave de API; ao sair da equipe ou trocar de máquina, exclua a chave correspondente.

Onde armazenar

# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"

[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效

# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key

O .claude/settings.json de nível de projeto do Claude Code geralmente é commitado no repositório, e a documentação oficial do Claude Code também recomenda explicitamente não escrever credenciais ali. Coloque a chave de API no ~/.claude/settings.json de nível de usuário, ou no .claude/settings.local.json do projeto que não é commitado.

O que fazer se vazar

Encontre-a na lista de “Chave de API”, clique no ícone “Desativar” da coluna “Ações”, ou selecione “Excluir” no menu ”⋯”. Após desativar, ela deixa de funcionar imediatamente; usá-la novamente retornará 401 Invalid token.
Crie uma nova chave de API e substitua-a onde estava sendo usada.
Abra os registros de chamadas (menu “Registros de chamadas” do console), clique em “Expandir”, preencha “Nome do token” com o nome desta chave de API para filtrar e verifique se há chamadas recentes que não foram iniciadas por você.

Perguntas frequentes

A chave da API pode ser usada ao mesmo tempo no Claude Code e no Cursor?

Sim, a chave de API não é vinculada a uma ferramenta. Porém, se você misturar o uso, os registros não mostrarão quem gastou o quê, então ainda assim é recomendável criar chaves separadas.

Aviso Invalid token / 401 é problema da chave da API?

Na maioria dos casos, sim. Causas comuns: espaços ou quebras de linha copiados junto, chave de API já excluída, preenchida no campo errado da ferramenta. Para a verificação item a item, consulte códigos de erro e solução de problemas.

A chave da API expira?

Por padrão, nunca expira. Ao criar ou editar, é possível definir um horário em “Data de expiração”; após expirar, as chamadas retornam 401 Invalid token, a mesma resposta de quando a chave de API está incorreta. A coluna “Expira” da lista mostra a data de expiração de cada chave de API.