切换外观
查询 Anthropic 可用模型
GET/models- 鉴权
- Bearer API Key
- 执行方式
- 按所调用的完整地址执行
接口说明
本页说明查询 Anthropic 可用模型能力的共同请求与响应结构,各地址的权益、错误与限制按完整公开地址分别列出。
请求
以下请求头、参数与报文结构适用于本页列出的全部完整公开地址。
方法:
GET鉴权:
x-api-key: ${TOKENFACTORY_API_KEY}或Authorization: Bearer ${TOKENFACTORY_API_KEY}(二选一)
请求头
| 名称 | 必填 | 值或类型 | 说明 |
|---|---|---|---|
x-api-key | 二选一 | ${TOKENFACTORY_API_KEY} | Anthropic 官方 SDK 使用的 API Key 请求头 |
Authorization | 二选一 | Bearer ${TOKENFACTORY_API_KEY} | Bearer API Key 请求头 |
anthropic-version | 是 | string | Anthropic API 版本;官方 SDK 会自动发送。 |
路径参数:无
查询参数
| 名称 | 必填 | 类型 | 说明 | 示例或约束 |
|---|---|---|---|---|
after_id | 否 | string | 返回该模型之后的下一页;不得与 before_id 同时提供。 | — |
before_id | 否 | string | 返回该模型之前的上一页;不得与 after_id 同时提供。 | — |
limit | 否 | integer (int32) | 每页模型数,默认 20,范围 1 至 1000。 | 默认:20;最小值:1;最大值:1000 |
请求字段:无
请求报文:无请求体
响应
成功状态:200
响应头
| 名称 | 值或类型 | 说明 |
|---|---|---|
Content-Type | application/json | 响应媒体类型 |
request-id | string | 本次请求的关联 ID;错误响应体的 request_id 与其相同。 |
响应字段
| 字段 | 类型 | 必填 | 说明 | 示例或约束 |
|---|---|---|---|---|
data | object[] | 是 | 当前页按真实发布时间从新到旧排列的模型。 | 示例:[{"capabilities":null,"created_at":"2026-08-14T00:00:00Z","display_name":"YOU... |
data[].capabilities | object | 是 | 经路线验证的能力对象;当前未核实时为 null。 | 示例:null;可为 null |
data[].created_at | string (date-time) | 是 | 已核实模型发布时间,使用 RFC 3339 UTC 时间。 | 示例:"2026-08-14T00:00:00Z" |
data[].display_name | string | 是 | 面向开发者展示的模型名称。 | 示例:"YOUR MODEL" |
data[].id | string | 是 | 调用请求中填写的 canonical 模型 ID。 | 示例:"YOUR_MODEL_ID" |
data[].max_input_tokens | integer (int64) | 是 | 已核实的最大输入 Token 数;未知时为 null。 | 示例:200000;可为 null |
data[].max_tokens | integer (int64) | 是 | 已核实的协议最大输出 Token 数;未知时为 null。 | 示例:8192;可为 null |
data[].type | string | 是 | Anthropic 兼容资源类型,固定为 model。 | 示例:"model";可选值:"model" |
first_id | string | 是 | 当前页首个模型 ID;空页为 null。 | 示例:"YOUR_MODEL_ID";可为 null |
has_more | boolean | 是 | 当前翻页方向是否仍有更多模型。 | 示例:false |
last_id | string | 是 | 当前页末个模型 ID;空页为 null。 | 示例:"YOUR_MODEL_ID";可为 null |
返回报文
媒体类型:application/json
json
{
"data": [
{
"capabilities": null,
"created_at": "2026-08-14T00:00:00Z",
"display_name": "YOUR MODEL",
"id": "YOUR_MODEL_ID",
"max_input_tokens": 200000,
"max_tokens": 8192,
"type": "model"
}
],
"first_id": "YOUR_MODEL_ID",
"has_more": false,
"last_id": "YOUR_MODEL_ID"
}错误
| 适用完整地址 | 状态 | 错误码 | 常见触发 | 重试 | 建议动作 | 结果风险 |
|---|---|---|---|---|---|---|
https://api.tokenfactory.cn/anthropic/v1/modelshttps://api.tokenfactory.cn/anthropic/coding/v1/models | 400 | invalid_request_error | 请求参数或请求体缺字段、格式错误或不受支持 | 否 | 修正请求后重试 | 无 |
https://api.tokenfactory.cn/anthropic/v1/modelshttps://api.tokenfactory.cn/anthropic/coding/v1/models | 401 | authentication_error | x-api-key 与 Bearer API Key 均缺失、格式错误或不可用 | 否 | 检查 x-api-key 或 Bearer API Key、Key 状态与实名状态 | 无 |
https://api.tokenfactory.cn/anthropic/v1/modelshttps://api.tokenfactory.cn/anthropic/coding/v1/models | 500 | api_error | 平台内部出现未预期错误 | 视情况 | 记录请求时间并稍后重试;持续出现时联系平台 | 中到高 |
错误返回报文
适用完整地址
https://api.tokenfactory.cn/anthropic/v1/models、https://api.tokenfactory.cn/anthropic/coding/v1/models
HTTP 400;Content-Type: application/json;响应头:request-id: string
json
{
"error": {
"message": "请求参数或请求体缺字段、格式错误或不受支持",
"type": "invalid_request_error"
},
"request_id": "req_0123456789abcdef0123456789abcdef",
"type": "error"
}限制与计费
| 适用完整地址 | 限制或计费说明 |
|---|---|
https://api.tokenfactory.cn/anthropic/v1/models | 只鉴权,不检查或扣减余额。 按真实发布时间降序分页,仅返回 Anthropic Messages Surface 可见模型。 余额计费调用不会自动改用 Coding Plan 权益。 |
https://api.tokenfactory.cn/anthropic/coding/v1/models | 只鉴权,不预留套餐、不计入用量。 按真实发布时间降序分页,仅返回套餐与 Anthropic Surface 共同可见模型。 Coding Plan 权益独立核验;套餐不可用时不会自动改扣余额。 |
调用示例
cURL · https://api.tokenfactory.cn/anthropic/v1/models
sh
curl --request GET "https://api.tokenfactory.cn/anthropic/v1/models?limit=20" --silent --show-error --fail-with-body --max-time 60 --header "x-api-key: ${TOKENFACTORY_API_KEY}" --header "anthropic-version: 2023-06-01"cURL · https://api.tokenfactory.cn/anthropic/coding/v1/models
sh
curl --request GET "https://api.tokenfactory.cn/anthropic/coding/v1/models?limit=20" --silent --show-error --fail-with-body --max-time 60 --header "x-api-key: ${TOKENFACTORY_API_KEY}" --header "anthropic-version: 2023-06-01"相关说明
这是平台当前可用模型列表;只鉴权、不计费,可用模型会随所用完整地址和上架状态变化。