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.

TL;DR · 4 passos:

base_url → https://api.usetokia.com/v1
api_key → sua sk-tokia-…
Troca model pra um ID da lista /docs/models
Saldo cai automaticamente conforme uso (acompanhe em /dashboard/usage)

ℹTokia mantém compatibilidade com 4 endpoints OpenAI: /v1/chat/completions, /v1/embeddings, /v1/images/generations, /v1/audio/transcriptions. O modelo é referenciado pelo ID upstream (ex: openrouter/openai/gpt-4o-mini) — ver lista em Modelos.

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 contato@usetokia.com → resposta em pt-BR em horário comercial.
Markup transparente. Cada modelo tem multiplicador declarado em /docs/pricing. Sem surpresa na fatura.

Tabela de compatibilidade

Recurso OpenAI	Status Tokia	Notas
`POST /v1/chat/completions`	✓	Compat total. Streaming SSE funciona.
`POST /v1/images/generations`	✓	Via Fal.ai (flux/schnell, sdxl). Parâmetros próprios documentados.
`POST /v1/embeddings`	✓	JSON pass-through. Doc em /docs/api/embeddings.
`POST /v1/audio/transcriptions` (Whisper)	✓	multipart/form-data até 25MB. Doc em /docs/api/audio.
`function_call` / `tools`	✓	Suportado 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 upstream + markup: a fatura mostra cost_billed_brl (debitado do seu saldo) e cost_upstream_usd (referência interna). Você paga só em BRL.
Suspensão automática: quando saldo zera, Tokia suspende todas as virtual 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$ 10) + 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