模型

公开模型目录展示允许公开发现的模型，包括适用的上下文窗口与标明计价单位的公开价格。base URL 与支持的 HTTP 路径见 API 端点。

版本化机器可读模型目录支持通过校验的语音转文字和文字转语音条目，并按单位列出 USD 费率。这些目录类型不会新增模型 API 路径；支持的路径见API 端点。

公开模型页面和控制台模型列表以卡片展示每个模型的费率与单位。语音转文字模型同时提供时长和 token 费率时，时长费率与整组 token 费率（文本输入、音频输入、文本输出）是两种替代计费依据，不会叠加。卡片省略不适用的价格项，零价项显示“不计费”，不附带单位。

控制台的模型页会在页面 URL 中保留搜索条件和选中的模型。刷新页面或重新打开链接即可恢复该视图；从模型详情返回列表时，搜索条件也会保留。

调用模型

调用对话模型时，在请求体中传入目录中显示的模型 id：

{
  "model": "YOUR_MODEL_ID",
  "messages": [{ "role": "user", "content": "Hello" }]
}

判定模型使用不同的路径与不同的请求形状，见 判定 API。

定价

价格即为你支付的金额，从预付额度扣减。文本模型的输入、缓存与输出按每 100 万 token 展示。音频价格区分输入与输出、文本与音频：时长按每分钟展示，字符按每 100 万字符展示，token 按每 100 万 token 展示。换算使用目录费率，不改变计费依据。

模型配置上下文分档价格时，目录和模型详情会列出每个输入 token 区间及其价格。输入数量包含缓存 token。整笔请求的输入、缓存输入和输出均按对应区间的价格计费，只使用命中的一档，不逐档累加。输入少于首个阈值时使用基础价。没有配置上下文分档的模型保持平价。

机器可读目录通过 pricing.contextPriceTiers 返回各档价格。thresholdTokens 是该档开始适用的输入 token 数，价格为每百万 token 的美元十进制字符串。

可用性

目录中的状态表示模型当前是否可调用。不可用模型仍会列出供参考，但会拒绝新流量。

如果上游确认某个模型已不存在，且没有其他上游能提供它，Tokener.ai 会把它从模型目录中移除。临时故障不会让模型从目录中消失。

访问与展示

受限模型仅供获授权的组织使用，也包括绑定到获授权 Partner 的组织。因此，组织内的模型目录可能与公开目录不同。API key 自身的模型限制仍然适用。

隐藏模型不会出现在模型目录中，包括 GET /v1/models。获授权的 key 可以通过模型 ID 直接调用隐藏模型；目录中没有某个模型，不代表已知 ID 无法调用。模型授权变更需要时间生效，保存成功不保证立即撤权。如果模型目录返回 503，直接调用仍按正常的授权与可用性规则处理。