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.
curl https://api.usetokia.com/modelsConsulta 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.
curl https://api.usetokia.com/models \
-H "Authorization: Bearer $TOKIA_API_KEY"Filtros
| Parâmetro | Exemplo | Efeito |
|---|---|---|
category | ?category=llm | Só uma categoria: llm (ou chat), image, audio, video, embedding. |
useCase | ?useCase=conversa | Só os modelos do catálogo marcados com esse caso de uso. |
featured | ?featured=true | Só os modelos recomendados. |
format | ?format=litellm | Devolve um trecho de model_list em YAML para o LiteLLM (veja abaixo). |
Resposta
{
"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: sempreBRL.updated_at: momento da cotação usada no cálculo dos preços.models[].id: o id que você manda emmodelnas chamadas.models[].aliases: outros ids aceitos para o mesmo modelo, com o mesmo preço.price_brl_input_per_mtokeprice_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;nullquando 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ãonull.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) ouunknown_partner_price(o parceiro não informou o preço agora). Com preço por token, vemnull.
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.
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.
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.0000017Chamando 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.
#!/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:
raiseNo config.yaml do seu LiteLLM, inclua o arquivo gerado:
include:
- tokia-models.yaml
general_settings:
master_key: os.environ/LITELLM_MASTER_KEY