(3) Criar uma Chave de API

Uma chave de API (parecida com sk-xxxxxx) é o "segredo" que você insere no seu cliente. Ela equivale às credenciais da sua conta, então mantenha-a em segurança e nunca a divulgue.

Passos para criar

1. Faça login no Console e vá em Gerenciamento de Tokens à esquerda.
2. Clique em Adicionar Token no topo da página.
3. Preencha os detalhes do token na caixa de diálogo:
   • Nome do token: para diferenciar os usos, ex.: Claude Code, Codex, Image.
   • Grupo do token: obrigatório — o grupo determina quais modelos o token pode usar (veja abaixo).
   • Validade: o padrão é "Nunca expira", ou defina um período de validade conforme necessário.
   • Cota: mesmo com "Cota ilimitada" ativada, a cota realmente utilizável do token ainda é limitada pelo saldo da sua conta.
   • Restrições de acesso: se não tiver certeza, mantenha os padrões — não ative à toa restrições de modelo ou listas de IPs permitidos.
4. Clique em Enviar para criar e, em seguida, clique no botão Copiar à direita do token para obter a chave.

Você deve escolher o grupo certo

Um passo crítico

O grupo do token determina diretamente quais modelos ficam disponíveis. Por exemplo, para usar o Claude Code, escolha um grupo Claude; para usar o Codex, escolha um grupo Codex. Se você escolher o grupo errado, facilmente vai se deparar com "model does not exist" ou chamadas que falham ao configurar seu cliente.

Grupos mais usados da Tianshu (veja Grupos de Tokens para detalhes):

Cenário	Grupo recomendado	Observações
Claude Code (apenas CLI)	claude-cconly	Suporta apenas conexões do Claude Code; ótimo custo-benefício
Claude (qualquer cliente)	claude-max / claude-kiro	Utilizável em diversos clientes
Programação com Codex	codex / codex-pro / codex-plus / codex-free	Pools de contas diferentes; escolha conforme a necessidade
Geração de imagens com IA	生图专用	Modelo de imagem GPT (gpt-image)

Veja quais modelos estão em um grupo

Não tem certeza de quais modelos um grupo suporta? Vá ao Marketplace de Modelos:

1. Abra o Marketplace de Modelos e selecione um grupo em "Grupos de tokens disponíveis" à esquerda.
2. Os cartões de modelo à direita mostrarão os modelos disponíveis naquele grupo, suas taxas de desconto e status de disponibilidade.

Veja Usando o Marketplace para mais detalhes.

Próximo passo

Depois de criar seu token, faça uma verificação de ambiente para confirmar que sua máquina consegue executar as ferramentas de CLI.