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) / 4Niveaux : 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).