Tokia
Entrar
Documentação
⌘K

Migrar do OpenAI

Tokia expõe a API no formato OpenAI-compatible. A migração é trocar duas linhas: api_key e base_url. O resto do seu código continua igual.

Diff mínimo

diff
  from openai import OpenAI

  client = OpenAI(
-     api_key=os.environ["OPENAI_API_KEY"],
+     api_key=os.environ["TOKIA_KEY"],
+     base_url="https://api.usetokia.com/v1",
  )

  response = client.chat.completions.create(
-     model="gpt-4o-mini",
+     model="openrouter/openai/gpt-4o-mini",
      messages=[{"role": "user", "content": "Hello"}],
  )

Por que migrar

  • Pagar em BRL. Sem cartão internacional, sem volatilidade de câmbio. pix direto na recarga.
  • Multi-modelo, 1 key. A mesma key acessa GPT-4o mini, Claude Sonnet, Gemini, DeepSeek, Llama, Flux, SDXL e Kling. Sem precisar gerenciar 5 contas.
  • Suporte em português. Email suporte@usetokia.com.br → resposta em pt-BR em horário comercial.
  • Preço transparente. Você vê o preço de cada modelo em reais em /docs/pricing. Sem surpresa na fatura.

Tabela de compatibilidade

Recurso OpenAIStatus TokiaNotas
POST /v1/chat/completionsCompat total. Streaming SSE funciona.
POST /v1/images/generationsModelos flux/schnell e sdxl. Parâmetros próprios documentados.
POST /v1/embeddingsJSON pass-through. Doc em /docs/api/embeddings.
POST /v1/audio/transcriptions (Whisper)multipart/form-data até 25MB. Doc em /docs/api/audio.
function_call / toolsSuportado nos modelos que aceitam (GPT-4o mini, Claude, etc).
Streaming (stream: true)SSE compatível com OpenAI SDK.
Vision (image input)Modelos multimodais (GPT-4o, Gemini Flash, Claude Sonnet).
Fine-tuning (/v1/fine_tuning/jobs)Não suportado, Tokia é gateway, não treina.

Diferenças de comportamento

  • Cobrança em reais: a resposta traz cost_billed_brl (o que foi debitado do seu saldo). Você paga só em BRL, sem precisar pensar em câmbio.
  • Suspensão automática: quando saldo zera, Tokia suspende todas as API keys instantaneamente (anti-overdraft). Cliente precisa recarregar e gerar nova key.
  • Reconcile a cada 60s: consumo aparece no dashboard com até 1 minuto de delay. Se você precisa ver consumo em tempo real, use o response usage.total_tokens da própria chamada.

Checklist de migração

  • [ ] Criar conta em usetokia.com/dashboard (Google OAuth)
  • [ ] Recarregar saldo pix (mínimo R$ 25) + preencher CPF/CNPJ no modal
  • [ ] Criar API key no dashboard, salvar em .env como TOKIA_KEY
  • [ ] Trocar OPENAI_API_KEY → TOKIA_KEY no app
  • [ ] Adicionar base_url="https://api.usetokia.com/v1"
  • [ ] Atualizar model pra ID Tokia (ex: openrouter/openai/gpt-4o-mini)
  • [ ] Smoke test com 1 chamada simples
  • [ ] (Opcional) Configurar Auto Top-Up no dashboard pra não ficar sem saldo