Models API 是当前模型 ID、基础 USD 价格范围、能力和限制的公开来源。页面中的模型名称仅用于调用示例。
https://api.tokensapi.cn/v1GET /models请求地址固定，请根据当前页面的参数说明替换模型 ID 和业务输入。
${base_url}/models${base_url}/models/{model}同一公开模型目录兼容 OpenAI、Claude 和 Gemini 协议外形。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
Authorization | string | 否 | — | OpenAI-compatible Bearer API Key。 |
x-api-key | string | 否 | — | Claude-compatible API Key Header。 |
x-goog-api-key / ?key= | string | 否 | — | Gemini-compatible API Key Header 或查询参数。 |
object / data | object | array | 否 | — | OpenAI-compatible 列表响应。 |
has_more / first_id / last_id | boolean | string | 否 | — | Claude-compatible 列表辅助字段。 |
models[] | array | 否 | — | Gemini-compatible 列表响应。 |
详情端点返回当前模型公开能力和范围；字段是否出现以协议响应为准。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
id | string | 否 | — | 精确模型 ID。 |
price.input_price_range | [number, number] | 否 | — | 基础 USD 输入价格范围。 可选值 / 约束：单位：USD / 百万 tokens。 |
price.output_price_range | [number, number] | 否 | — | 基础 USD 输出价格范围。 可选值 / 约束：单位：USD / 百万 tokens。 |
price.group_ratio | number | 否 | — | 当前账号共享的价格倍率。 可选值 / 约束：用户可见价格范围 = 基础价格范围 × group_ratio；不改变服务商价格排序。 |
modalities | string[] | 否 | — | 输入和输出模态。 |
input_token_limit | integer | 否 | — | 最大输入 token 限制。 |
output_token_limit | integer | 否 | — | 最大输出 token 限制。 |
throughput_range | [number, number] | 否 | — | 公开吞吐范围。 可选值 / 约束：单位：tokens/s。 |
latency_range | [number, number] | 否 | — | 公开延迟范围。 可选值 / 约束：单位：秒。 |
以下字段属于 HTTP 响应 Header，不属于 JSON、SSE 事件或二进制响应 body。网络层失败而未进入网关时不保证返回。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
X-Client-Request-Id | string | 否 | — | 调用方在请求中提供时回显；未提供时网关不会自动生成。 |
X-Upstream-Request-Id | string | 否 | — | 通常用于网关请求追踪，不代表 provider 的原始 request ID。 |
调用前从列表或详情端点读取当前模型 ID 与能力。响应不承诺返回 provider 列表；错误结构遵循所选 OpenAI、Claude 或 Gemini 协议。
示例使用占位符，请替换为模型详情页中当前可用的 model ID，并将 API Key 保存在服务端环境变量中。
curl https://api.tokensapi.cn/v1/models \
-H "Authorization: Bearer $TOKEN_MARKET_API_KEY"