---
title: "Obter e gerenciar chaves de API"
description: "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."
headingIds: {"Criar uma chave de API":"section-1","Uma chave de API por ferramenta":"section-2","Onde armazenar":"section-3","O que fazer se vazar":"section-4","Perguntas frequentes":"section-5"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentação mantida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fontes e correções](https://1zheai.com/en/editorial/).

Encontrou um erro? [Contate o suporte](mailto:support@1zheai.com) com o endereço da página e uma descrição. Não envie chaves de API ou credenciais de conta.

</aside>
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

<Steps>
<Step title="Entrar no console">

Abra [1zheai.com/console](https://1zheai.com/console?lng=pt).

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

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

</Step>
</Steps>

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

<CodeGroup>
```bash title="Shell 配置（macOS / Linux）"
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows（当前用户，持久）"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效
```
```bash title=".env（项目本地）"
# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key
```
</CodeGroup>

<Warning>

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.

</Warning>

## O que fazer se vazar

1. 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`.
2. Crie uma nova chave de API e substitua-a onde estava sendo usada.
3. 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

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

</Accordion>
<Accordion title="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](/pt/docs/troubleshooting/).

</Accordion>

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

</Accordion>
</AccordionGroup>