概念
数据模型与证据
有几条约定贯穿每个端点。理解一次，整套 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。