API de preços

A tabela de preços do Tokia está disponível em uma API pública. Use para mostrar preços no seu sistema, calcular custo antes de chamar um modelo ou manter o bilhetamento de um LiteLLM próprio sincronizado com o que o Tokia cobra.

bash
curl https://api.usetokia.com/models

Consulta pública ou com a sua chave

  • Sem autenticação: devolve a tabela pública, igual à página Preços.
  • Com a sua chave (Authorization: Bearer sk-...): devolve, no mesmo formato, os preços que a sua conta paga. É o que você deve usar para bilhetar seus próprios clientes. Para chave de time, vale o preço da conta dona do time.
bash
curl https://api.usetokia.com/models \
  -H "Authorization: Bearer $TOKIA_API_KEY"

Filtros

ParâmetroExemploEfeito
category?category=llmSó uma categoria: llm (ou chat), image, audio, video, embedding.
useCase?useCase=conversaSó os modelos do catálogo marcados com esse caso de uso.
featured?featured=trueSó os modelos recomendados.
format?format=litellmDevolve um trecho de model_list em YAML para o LiteLLM (veja abaixo).

Resposta

json
{
  "currency": "BRL",
  "updated_at": "2026-11-19T12:00:00.000Z",
  "models": [
    {
      "id": "gemini-flash",
      "upstream_model_id": "openrouter/google/gemini-2.5-flash",
      "display_name": "Gemini 2.5 Flash",
      "category": "llm",
      "is_free": false,
      "description": "Rápido e barato.",
      "is_featured": true,
      "use_cases": ["conversa", "traducao"],
      "price_brl_input_per_mtok": 6.79,
      "price_brl_output_per_mtok": 56.62,
      "price_brl_cache_read_per_mtok": 1.7,
      "price_brl_cache_write_per_mtok": 8.68,
      "aliases": ["openrouter/google/gemini-2.5-flash"],
      "price_unavailable_reason": null
    }
  ]
}

Campos

  • currency: sempre BRL.
  • updated_at: momento da cotação usada no cálculo dos preços.
  • models[].id: o id que você manda em model nas chamadas.
  • models[].aliases: outros ids aceitos para o mesmo modelo, com o mesmo preço.
  • price_brl_input_per_mtok e price_brl_output_per_mtok: preço por milhão de tokens de entrada e de saída.
  • price_brl_cache_read_per_mtok: preço por milhão de tokens de entrada lidos do cache do provedor; null quando o parceiro não informa.
  • price_brl_cache_write_per_mtok: preço por milhão de tokens gravados no cache, quando o parceiro cobra a gravação; senão null.
  • price_brl_per_image: preço por imagem, nos modelos de imagem que cobram assim.
  • price_unavailable_reason: quando não há preço por token, explica o motivo: free (gratuito), billed_per_image (cobrado por imagem), billed_outside_tokens (cobrado por outra unidade, como segundos de vídeo ou áudio) ou unknown_partner_price (o parceiro não informou o preço agora). Com preço por token, vem null.

Todos os preços estão em reais por milhão de tokens, já com tributos e custos da operação. O custo de uma chamada é tokens × preço ÷ 1.000.000 para cada tipo de token.

Com que frequência consultar

O preço acompanha o custo dos parceiros e o câmbio e pode mudar. Consulte no máximo uma vez por hora. A resposta pública sai com Cache-Control: public, max-age=3600; a autenticada, com Cache-Control: private, max-age=300.

Toda resposta traz um ETag. Mande o valor de volta em If-None-Match: se nada mudou, a API responde 304 sem corpo e você mantém o que já tem.

bash
curl -i https://api.usetokia.com/models \
  -H 'If-None-Match: W/"valor-do-etag-anterior"'

Formato LiteLLM

Com ?format=litellm, a API devolve um trecho de model_list pronto para o config.yaml do LiteLLM. O model_name é o id do Tokia, e os custos em model_info estão em reais por token. Modelos sem preço por token (gratuitos, por imagem, por segundo) ficam listados só num comentário no fim.

yaml
model_list:
  - model_name: "gemini-flash"
    litellm_params:
      model: "openai/gemini-flash"
      api_base: "https://api.usetokia.com/v1"
      api_key: os.environ/TOKIA_API_KEY
    model_info:
      input_cost_per_token: 0.00000679
      output_cost_per_token: 0.00005662
      cache_read_input_token_cost: 0.0000017

Chamando com a sua chave, os custos do trecho são os da sua conta, e o LiteLLM passa a bilhetar pelo que você realmente paga.

Exemplo: manter o LiteLLM sincronizado

O script abaixo baixa o trecho com a sua chave, usa o ETag para não baixar de novo o que não mudou e grava tokia-models.yaml. Rode de hora em hora (cron ou agendador) e reinicie o LiteLLM quando o arquivo mudar.

python
#!/usr/bin/env python3
import os
import pathlib
import urllib.error
import urllib.request

URL = "https://api.usetokia.com/models?format=litellm&category=llm"
DESTINO = pathlib.Path("tokia-models.yaml")
ETAG = pathlib.Path(".tokia-precos.etag")

pedido = urllib.request.Request(URL)
pedido.add_header("Authorization", "Bearer " + os.environ["TOKIA_API_KEY"])
if ETAG.exists() and DESTINO.exists():
    pedido.add_header("If-None-Match", ETAG.read_text().strip())

try:
    with urllib.request.urlopen(pedido, timeout=30) as resposta:
        DESTINO.write_bytes(resposta.read())
        ETAG.write_text(resposta.headers.get("ETag", ""))
        print("preços atualizados em", DESTINO)
except urllib.error.HTTPError as erro:
    if erro.code == 304:
        print("preços sem mudança")
    else:
        raise

No config.yaml do seu LiteLLM, inclua o arquivo gerado:

yaml
include:
  - tokia-models.yaml

general_settings:
  master_key: os.environ/LITELLM_MASTER_KEY