Tokiadocs
⌘K

Cursor IDE + Tokia

Cursor é OpenAI-compatible nativo — você só troca base URL e API key. 2 min de setup. Sem extensão. Sem fork.

Setup (2 minutos)

1. Pega sua key Tokia

Em /dashboard/keys, clica "Criar API Key". Copia o sk-tokia-….

2. Abre Cursor Settings

Cmd/Ctrl + , → seção "Models"→ role até "OpenAI API Key".

3. Configura Override

Marca "Override OpenAI Base URL". Preenche:

OpenAI API Key:        sk-tokia-...        ← sua key
Override OpenAI Base URL: https://api.usetokia.com/v1

4. Adiciona modelos custom

Cursor lista por padrão GPT-4o, Claude etc. Pra usar modelos curados Tokia (DeepSeek V3 mais barato, Gemini Flash etc), adicione em "+ Add Model":

deepseek-v3                    ← 1/15 do preço do GPT-4o
gpt-4o-mini                    ← se já costuma usar
claude-sonnet-4-6              ← texto longo / código
gemini-2-flash                 ← multimodal contexto longo
llama-3-3-70b                  ← open-source, sem lock-in

5. Testa

Cmd+L → "Hello, qual modelo você é?" → seleciona um dos modelos Tokia no dropdown → enviar.

Vantagens vs config padrão Cursor (OpenAI direto)

  • PIX em vez de cartão internacional — sem IOF 6.38%, sem spread cartão 3-4%, sem cadastro internacional
  • NF-e brasileira emitida automaticamente — contador aceita como despesa operacional CFOP 1.05
  • 27 modelos em vez de só OpenAI (Anthropic, Google, Fal.ai, DeepSeek, Llama, open-source)
  • Saldo pré-pago em BRL — sem surpresa no cartão fim de mês
  • Suporte PT-BR via WhatsApp / email — sem ticket OpenAI em inglês esperando 5 dias úteis

Cenário: Pair-programming com modelo barato

Configuração que devs sênior BR mais usam:

  • Cmd+K (inline edit) → deepseek-v3 (barato, rápido, ~85% qualidade GPT-4)
  • Cmd+L (chat) → claude-sonnet-4-6 pra refactor complexo / explicação arquitetural
  • Cmd+I (composer) → gpt-4o pra task multi-file (Cursor manda mais contexto)

Troubleshooting

Cursor diz "Invalid API Key"

  • Confirma que a key começa com sk-tokia- (não sk- só)
  • Confirma que copiou inteiro (cuidado com espaço no fim)
  • Testa rapidamente: curl -H "Authorization: Bearer sk-tokia-…" https://api.usetokia.com/v1/models

Modelo X não aparece no dropdown

Cursor cacheia lista de modelos. Após adicionar custom, reinicie o Cursor (Cmd+Q → reabrir). Lista atualiza.

Streaming não funciona

Streaming OpenAI-compatible funciona idêntico. Se travar, checa:

  • Tokia /status tá ok?
  • Cursor versão ≥ 0.40 (versões antigas tem bug de SSE)
  • Antivírus/proxy corporativo não tá bloqueando api.usetokia.com

"Modelo não disponível" / erro 404

Sua API key tem allowlist de modelos. Em /dashboard/keys edita a key e libera os modelos que vai usar (ou seta "todos").

Como funciona por baixo

Cursor manda POST /v1/chat/completions igual qualquer cliente OpenAI. Tokia:

  • Valida JWT (sua key)
  • Roteia pra provider upstream (OpenRouter, Fal, OpenAI direto, Anthropic, etc)
  • Faz streaming response de volta sem touching prompt
  • Cobra do seu saldo em BRL (markup decrescente)
  • Emite NF-e via Asaas no fim do mês

Você não troca SDK, não precisa wrapper, não muda 1 linha de código.

Próximos passos