コンセプト

データモデルとエビデンス

いくつかの規約がすべてのエンドポイントを貫いています。これらを一度理解すれば、API 全体が明快に読めます。

エンティティ

エンティティ	内容
Model	正規化されたモデルの識別子（例: `gpt-oss-120b`）。各プロバイダーの方言を横断して正規化されています。
Provider	実際に推論を提供する主体（Fireworks、Together、あるクラウド）。プロバイダー信頼ボードでランク付けされます。
Aggregator / Router	複数のプロバイダーを横断してルーティングするマーケットプレイス（OpenRouter、HuggingFace、0G、Novita、Requesty）。アグリゲーターボードでランク付けされます。
Offer	1 つの（model × provider × router）価格ポイント。価格、コンテキストウィンドウ、エビデンスタグを含みます。

すべてのオファーは、その数値をどのように把握したかを示します。これは TKX の信頼性の背骨です。

タグ	意味
official	ベンダーが公開した定価（レートカード）。
api	プロバイダーのライブ公開 API から読み取られたもの。
probe	TKX プローブによる測定値（実測の TTFT / TPS / 稼働率）。
self	自己申告 — 常にランクを下げられ、真実として扱われることはありません。

プロバイダーは同じモデルを十数通りの方法で命名します。TKX はそれらを 1 つの正規 ID に正規化し、単一のモデル行がそれを提供するすべてのプロバイダーを集約するようにします。モデル詳細のパスパラメータには正規 ID を使用してください。

単一の数値でモデルをランク付けするために、実際のコストを支配する出力側に重み付けしたブレンド価格を使用します:

blended = (3 × input_per_1M + output_per_1M) / 4

アグリゲーターには tier が付きます。live は TKX が今それらの実データを取り込んでいることを意味します。listed は追跡しているがまだ統合されていないことを意味します（表示はされますが、捏造された数値でスコア付けされることはありません）。

すべての収集実行は、データベースへのアクセスなしに /data/provenance.json で監査可能です — ソースごとのタイムスタンプ、HTTP ステータス、ペイロードの SHA-256。