模型列表介面 | 土土金 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，我們幫你排查。