Tokia
Entrar
Documentação
⌘K

Seguranca da API

Suas chaves de API dao acesso ao seu saldo e a todos os modelos do seu plano. Protege-las e responsabilidade sua. Esta pagina cobre boas praticas para manter suas chaves seguras em producao.

Variaveis de ambiente

Guarde sua chave em uma variavel de ambiente, nunca no codigo-fonte:

bash
.env.local (nunca commitar)
TOKIA_API_KEY=tokia-xxxx...
typescript
const client = new OpenAI({
  apiKey: process.env.TOKIA_API_KEY,
  baseURL: "https://api.usetokia.com/v1",
});

Checklist

  • Adicione .env* ao .gitignore
  • Use .env.example com placeholders (sem valores reais)
  • Em CI/CD, configure via painel (Vercel, Railway, Coolify) — nunca em arquivo
  • Revise commits antigos por chaves vazadas com gitleaks ou trufflehog

Rotacao de chaves

Voce pode ter ate 5 chaves de API ativas ao mesmo tempo. Use isso para fazer rotacao sem downtime:

  1. Crie uma nova chave no painel de chaves
  2. Atualize a variavel de ambiente na sua aplicacao com a nova chave
  3. Aguarde o deploy/restart completar
  4. Delete a chave antiga no painel

Monitoramento de saldo

O Tokia cobra por uso (pre-pago). Se seu saldo zerar, as chamadas retornam 402 insufficient_balance. Para evitar interrupcoes:

  • Alerta de saldo baixo: o Tokia envia um e-mail quando seu saldo cai abaixo de R$ 10,00. Voce tambem pode acompanhar o saldo em tempo real no dashboard.
  • Auto Top-Up: configure recarga automatica para nunca ficar sem saldo. Veja Auto Top-Up.
  • Logs de uso: acompanhe o consumo por modelo e por chave nos logs para detectar picos inesperados.

Rate limits como protecao

Cada chave tem limites de RPM (requests por minuto) e TPM (tokens por minuto). Esses limites protegem contra uso excessivo (intencional ou acidental). Se uma chave for comprometida, o rate limit limita o dano. Veja Rate Limits.

Se sua chave vazou

  1. Acesse o painel de chaves e delete a chave comprometida imediatamente
  2. Crie uma nova chave e atualize sua aplicacao
  3. Revise os logs para identificar chamadas nao autorizadas
  4. Se houve uso indevido, entre em contato pelo suporte