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) / 4Ní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).