API keys são sk-tokia-... que você usa no header Authorization: Bearer ... das chamadas API. Cada key tem budget USD próprio ligado ao seu saldo BRL e pode ser restrita a modelos específicos.

Passo 1 — Acesse /dashboard/keys

No menu lateral, clica "API Keys". Você vê a lista de chaves ativas.

Lista de API keys vazia

Se for sua primeira vez, vai mostrar "Nenhuma chave ativa. Crie a primeira no botão acima.".

Passo 2 — Botão "Criar key"

Modal abre com 2 seções:

Nome da key — qualquer texto entre 3 e 50 caracteres. Boa prática: usa nome descritivo do projeto. Exemplos:

producao-chatbot (key da app prod do chatbot)
dev-local (sua máquina pessoal)
n8n-workflow (key dedicada pro n8n)

Modelos permitidos — 9 modelos disponíveis hoje:

LLM: Claude Sonnet 4.6, DeepSeek V3, Gemini Flash, GPT-4o mini, Llama 3.3 70B, Tokia Free Test
Imagem: Flux Schnell, Stable Diffusion XL
Vídeo: Kling Video

Você pode marcar todos (default), nenhum (botões Todos/Nenhum) ou selecionar manualmente. Recomendação:

Key de teste: só Tokia Free Test (custo R$ 0)
Key de produção restrita: apenas os modelos que a app usa de fato
Key admin: todos

Passo 3 — Budget cap opcional (avançado)

Se você quer limitar gasto desta key específica, expande a seção de budget e digite valor em BRL (R$ 0,50 a R$ 100.000). Útil pra:

Key compartilhada com freelancer que pode gastar até R$ 50
Key dev/sandbox limitada a R$ 5/mês
Key produção com cap mensal pra evitar surpresa

Sem budget custom, a key usa saldo global da conta.

Passo 4 — Clique "Criar"

A key é criada no LiteLLM (gateway interno) + persistida no banco Tokia. Resposta retorna:

Plaintext (copie agora):
sk-Igbws93hgs-7H8cuQDoGJA

Nome: producao-chatbot
Budget USD inicial: $ 0.50
Modelos permitidos: 1 de 9

⚠️ Importante — plain key aparece UMA vez

Clica "Copiar key" e salva em local seguro (1Password, Bitwarden, .env). Depois disso, só o prefixo (sk-Igbws...) fica visível. Pra trocar a key você precisa revogar e criar nova.

Passo 5 — Use a key

No seu código:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.usetokia.com/v1",
    api_key="sk-Igbws93hgs-7H8cuQDoGJA",
)

Ou em JS:

const tokia = new OpenAI({
  baseURL: "https://api.usetokia.com/v1",
  apiKey: process.env.TOKIA_API_KEY,
});

Revogar key (quando vazar)

Se a key vazou em chat/Git/Slack:

Vai em /dashboard/keys
Card da key → botão "Revogar"
Confirma → key fica is_active: false no banco + revogada no LiteLLM
Toda chamada futura retorna 401

A revogação é imediata. Não tem janela de graça.

Próximo passo

Faça sua primeira chamada API em /docs/manual/03-primeira-chamada-api.

Criar sua primeira API key