# Tokia

> Gateway brasileiro de IA, OpenAI-compatible. PMEs brasileiras acessam 27+
> modelos (OpenAI, Anthropic, Google, Llama via OpenRouter, Fal.ai imagem/vídeo)
> com pagamento em PIX/cartão BR, NF-e automática, suporte em português e
> markup decrescente transparente.

## Documentação principal

- [Quickstart (2 min)](https://www.usetokia.com/docs/quickstart): primeira chamada com cURL/Python/Node
- [API Reference](https://www.usetokia.com/docs/api/reference): rotas OpenAI-compatible (chat, embeddings, images, audio)
- [Modelos](https://www.usetokia.com/docs/models): catálogo + IDs + custo
- [Pricing](https://www.usetokia.com/pricing): markup por modelo, calculadora
- [Webhooks](https://www.usetokia.com/docs/webhooks): eventos balance.low, balance.topped_up, key.suspended, etc.
- [Auto top-up](https://www.usetokia.com/docs/auto-topup): recarga automática via cartão Asaas
- [SDK Node](https://www.usetokia.com/docs/sdk): @tokia/sdk + @tokia/cli no npm
- [Migrando do OpenAI](https://www.usetokia.com/docs/migrating-from-openai): só trocar base_url e api_key
- [Sessions](https://www.usetokia.com/docs/sessions): agrupe requests da mesma conversa via header x-tokia-session-id, debug + atribuição custo
- [Prompts library](https://www.usetokia.com/docs/prompts): templates versionados com variáveis {{var}} + playground integrado, CRUD /me/prompts
- [MCP server](https://www.usetokia.com/docs/mcp): conecte Claude Desktop, Cursor, Cline, Continue.dev via Model Context Protocol
- [Pacotes verticais](https://www.usetokia.com/pacotes): IA verticalizada por setor — Imobiliária, Advogado, Loja, com prompts prontos
- [Pacote Imobiliária](https://www.usetokia.com/pacotes/imobiliaria): descrições de imóvel, WhatsApp 24/7, melhoria de fotos, captação leads
- [Pacote Advogado](https://www.usetokia.com/pacotes/advogado): resumos de processos, minutas de petição, busca jurisprudência, LGPD-ready
- [Pacote Loja](https://www.usetokia.com/pacotes/loja): catálogo em massa, atendimento WhatsApp, arte Instagram, email marketing

## Endpoints

- API base: `https://api.usetokia.com/v1` (OpenAI-compatible drop-in)
- Status público: `https://www.usetokia.com/status`
- Status JSON: `https://www.usetokia.com/status/status.json`
- DB health (Postgres SELECT 1): `https://api.usetokia.com/healthz/db`
- Changelog: `https://www.usetokia.com/changelog` (RSS em /changelog/rss.xml, JSON em /changelog.json)
- OpenAPI spec: `https://www.usetokia.com/openapi.yaml`
- Docs index (JSON): `https://www.usetokia.com/docs/index.json`
- Blog posts (JSON): `https://www.usetokia.com/blog/posts.json`
- Account export (JSON, auth required, LGPD Art. 18): `https://api.usetokia.com/me/export`

## Recursos extras

- [Comparação](https://www.usetokia.com/docs/comparison): Tokia vs OpenAI direto vs OpenRouter
- [Cookbook](https://www.usetokia.com/docs/cookbook): exemplos de prompt + caso de uso
- [Cursor setup](https://www.usetokia.com/docs/cursor): usar Tokia como provider no Cursor IDE
- [Custom GPT action](https://www.usetokia.com/docs/custom-gpt-action): manifest pra criar Action no ChatGPT
- [Marco 200 sprints](https://www.usetokia.com/milestone): linha do tempo do desenvolvimento

## Sobre

Operado pela [IT Booster Global](https://itbooster.com.br) (CNPJ 40.949.316/0001-49, Brasília/DF). Customer-of-record dos providers upstream — emite NF-e brasileira pelo uso de qualquer modelo. Suporte em português via contato@usetokia.com.