概念
資料模型與證據
有幾項慣例貫穿每個端點。理解一次,整套 API 就一目了然。
實體
| 實體 | 是什麼 |
|---|---|
| 模型 | 一個規範化的模型身分(例如 gpt-oss-120b),跨每家供應商的方言正規化。 |
| 供應商 | 實際提供推論服務者(Fireworks、Together、某雲)。在供應商信任榜上排行。 |
| 聚合器/路由器 | 跨供應商路由的市集(OpenRouter、HuggingFace、0G、Novita、Requesty)。在聚合器榜上排行。 |
| 報價 | 一個(模型 × 供應商 × 路由器)價格點,含價格、上下文視窗與一個證據標籤。 |
證據標籤
每個報價都說明我們如何得知其數字。這是 TKX 可信度的骨幹。
| 標籤 | 含義 |
|---|---|
| official | 廠商公布的標價(費率表)。 |
| api | 從供應商的即時公開 API 讀取。 |
| probe | 由 TKX 探針量測(真實 TTFT/TPS/在線率)。 |
| self | 自報 — 一律降級,絕不視為真實。 |
規範化模型 ID
供應商會用十幾種方式命名同一個模型。TKX 將它們正規化為單一規範化 id,使單一模型列能匯總所有提供該模型的供應商。請將規範化 id 作為模型詳情的路徑參數。
混合價格
為了以單一數字為模型排行,我們使用一個偏重輸出的混合價格,因為輸出主導了實際成本:
blended = (3 × input_per_1M + output_per_1M) / 4
層級:live 與 listed
聚合器帶有一個 tier:live 表示 TKX 目前正在接收其真實資料;listed 表示已追蹤但尚未整合(會顯示,但絕不以捏造數字評分)。
來源
i
每次採集執行都可在 /data/provenance.json 無需資料庫存取即可稽核 — 逐來源時間戳、HTTP 狀態與負載 SHA-256。