开始
模型列表接口
GET /v1/models 返回当前 Key 能调用的模型,也就是 Key 所在分组提供、并且通过模型白名单的模型。默认 OpenAI 格式,带 Claude 或 Gemini 认证头时返回对应的官方格式。
GET /v1/models 返回当前这把 Key 能调用的模型:它所在的分组提供、并且通过了 Key 的模型白名单的那些。默认返回 OpenAI 格式;带上 Claude 或 Gemini 的认证头时,返回对应官方 SDK 能解析的格式。
GET
https://open.tutujin.com/v1/models请求示例
curl https://open.tutujin.com/v1/models \
-H "Authorization: Bearer $TUTUJIN_API_KEY"import os
from openai import OpenAI
client = OpenAI(base_url="https://open.tutujin.com/v1", api_key=os.environ["TUTUJIN_API_KEY"])
for m in client.models.list():
print(m.id)import OpenAI from 'openai'
const client = new OpenAI({ baseURL: 'https://open.tutujin.com/v1', apiKey: process.env.TUTUJIN_API_KEY })
for await (const m of client.models.list()) {
console.log(m.id)
}响应(OpenAI 格式)
下面是结构示意,字段值是占位:
JSON
{
"success": true,
"object": "list",
"data": [
{
"id": "gpt-5.4-mini",
"object": "model",
"created": 1700000000,
"owned_by": "openai",
"supported_endpoint_types": ["openai"]
}
]
}| 字段 | 说明 |
|---|---|
data[].id | 模型名,调用时原样填进 model 参数 |
data[].object | 固定为 model |
data[].created | 时间戳,仅供参考,不代表模型的发布时间 |
data[].owned_by | 归属标识,仅供参考 |
data[].supported_endpoint_types | 这个模型支持的接口类型,例如 openai(Chat Completions)、anthropic(Claude Messages)、gemini、openai-response、embeddings、image-generation |
列表的内容由 Key 决定,换一把其他分组的 Key,返回的模型可能不同。想看全部模型和每个分组的价格,看模型与价格。
Claude 与 Gemini 格式
请求带上 x-api-key 和 anthropic-version 两个请求头时,返回 Anthropic 的模型列表格式,Anthropic SDK 的 client.models.list() 可以直接解析:
cURL
curl https://open.tutujin.com/v1/models \
-H "x-api-key: $TUTUJIN_API_KEY" \
-H "anthropic-version: 2023-06-01"JSON
{
"data": [
{
"id": "claude-sonnet-5-5",
"type": "model",
"display_name": "claude-sonnet-5-5",
"created_at": "2023-11-14T22:13:20Z"
}
],
"first_id": "...",
"last_id": "...",
"has_more": false
}带 x-goog-api-key 请求头,或者请求 GET /v1beta/models,返回 Gemini 的格式:
cURL
curl https://open.tutujin.com/v1beta/models \
-H "x-goog-api-key: $TUTUJIN_API_KEY"JSON
{
"models": [
{
"name": "gemini-3.8-flash",
"displayName": "gemini-3.8-flash"
}
],
"nextPageToken": null
}Gemini 格式里只有 name 和 displayName 有值,其余字段为空;name 是不带 models/ 前缀的模型名。
注意事项
- 列表只包含这把 Key 当前能用的模型。设置了模型白名单的 Key,只返回白名单里的模型。
- 另有
GET /v1/models/{model}查询单个模型,它只认识一部分常见模型名,不认识的会返回带model_not_found的错误对象。判断某个模型能不能调用,以列表接口为准。 - 模型列表变化不频繁,可以在服务启动时拉一次并缓存,不必每次请求前都查。
没找到答案?加客服微信 JsnonoChat,发送报错信息里的 request id,我们帮你排查。