Modèle de données et preuve
Quelques conventions traversent chaque endpoint. Comprenez-les une fois et toute l'API se lit clairement.
Entités
| Entité | Ce que c'est |
|---|---|
| Modèle | Une identité de modèle canonique (ex. gpt-oss-120b), normalisée entre les dialectes de chaque fournisseur. |
| Fournisseur | Qui assure réellement l'inférence (Fireworks, Together, un cloud). Classé sur le tableau de confiance des fournisseurs. |
| Agrégateur / Routeur | Une place de marché qui route entre les fournisseurs (OpenRouter, HuggingFace, 0G, Novita, Requesty). Classé sur le tableau des agrégateurs. |
| Offre | Un point de prix (modèle × fournisseur × routeur), avec les prix, la fenêtre de contexte et une étiquette de preuve. |
Étiquettes de preuve
Chaque offre indique comment nous connaissons ses chiffres. C'est l'épine dorsale de la crédibilité de TKX.
| Étiquette | Signification |
|---|---|
| official | Prix de liste publié par le fournisseur (grille tarifaire). |
| api | Lu depuis l'API publique en direct du fournisseur. |
| probe | Mesuré par une sonde TKX (TTFT / TPS / disponibilité réels). |
| self | Auto-déclaré — toujours déclassé, jamais traité comme vérité. |
Identifiants canoniques de modèle
Les fournisseurs nomment le même modèle d'une dizaine de façons. TKX les normalise en un seul identifiant canonique de sorte qu'une unique ligne de modèle agrège chaque fournisseur qui le sert. Utilisez l'identifiant canonique comme paramètre de chemin pour le détail du modèle.
Prix mixte
Pour classer un modèle par un seul nombre, nous utilisons un prix mixte pondéré vers la sortie, qui domine le coût réel :
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.
Niveaux : live vs listed
Les agrégateurs portent un tier : live signifie que TKX ingère leurs données réelles maintenant ; listed signifie suivi mais pas encore intégré (affiché, jamais noté sur des chiffres fabriqués).