模型列表接口 | 土土金 API 文档

GET /v1/models 返回当前这把 Key 能调用的模型：它所在的分组提供、并且通过了 Key 的模型白名单的那些。默认返回 OpenAI 格式；带上 Claude 或 Gemini 的认证头时，返回对应官方 SDK 能解析的格式。

GEThttps://www.tutujin.com/v1/models

请求示例

curl https://www.tutujin.com/v1/models \
  -H "Authorization: Bearer $TUTUJIN_API_KEY"

import os
from openai import OpenAI

client = OpenAI(base_url="https://www.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://www.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://www.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://www.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，我们帮你排查。