Modelo de dados e evidência
Algumas convenções percorrem cada endpoint. Entenda-as uma vez e toda a API fica clara.
Entidades
| Entidade | O que é |
|---|---|
| Modelo | Uma identidade canônica de modelo (por exemplo, gpt-oss-120b), normalizada entre o dialeto de cada provedor. |
| Provedor | Quem de fato serve a inferência (Fireworks, Together, uma nuvem). Classificado no painel de confiança de provedores. |
| Agregador / Roteador | Um marketplace que roteia entre provedores (OpenRouter, HuggingFace, 0G, Novita, Requesty). Classificado no painel de agregadores. |
| Oferta | Um ponto de preço (modelo × provedor × roteador), com preços, janela de contexto e uma etiqueta de evidência. |
Etiquetas de evidência
Cada oferta diz como conhecemos seus números. Esta é a espinha dorsal da credibilidade da TKX.
| Etiqueta | Significado |
|---|---|
| official | Preço de tabela publicado pelo fornecedor (tabela de preços). |
| api | Lido da API pública ao vivo do provedor. |
| probe | Medido por uma sonda da TKX (TTFT / TPS / disponibilidade reais). |
| self | Autodeclarado — sempre rebaixado no ranking, nunca tratado como verdade. |
IDs canônicos de modelo
Os provedores nomeiam o mesmo modelo de dezenas de maneiras. A TKX os normaliza para um único id canônico, de modo que uma única linha de modelo agregue todos os provedores que o servem. Use o id canônico como parâmetro de caminho para detalhe do modelo.
Preço combinado (blended)
Para classificar um modelo por um único número, usamos um preço combinado (blended) ponderado em direção à saída, que domina o custo real:
blended = (3 × input_per_1M + output_per_1M) / 4Volume & estimated spend
The Tokens (24h) and Volume figures on the model board are real routed usage read from one marketplace (OpenRouter) for the stated day — a measured slice, not global market share.
- Spend is a floor, not a midpoint: each model's tokens are priced at its cheapest measured rate (3:1 in:out blend, see above). Real bills are higher.
- Only models that report usage are counted. Rows that carry prices but no volume data are excluded from the total and never estimated.
- Free-tier traffic counts in volume but is never priced.
- If the upstream source stops publishing, the last good day is carried forward and flagged
stalein /data/usage.json — never silently.
Níveis: live vs listed
Os agregadores têm um tier: live significa que a TKX ingere seus dados reais agora; listed significa rastreado, mas ainda não integrado (exibido, nunca pontuado com base em números fabricados).