按能力筛选模型

GET/v1/models

通过查询参数按能力或类型筛选模型。

Bearer Token

筛选参数

除 limit / after 分页参数外，/v1/models 支持以下查询参数：

参数	类型	说明
type	string	按类型过滤：chat / image / audio / video / music。其中 embedding 已开通（当前仅 doubao-embedding-text / doubao-embedding-large 两个模型）；rerank 未开通（无在售模型）
capability	string	⚠️ 当前不生效：列表项不含 capabilities 字段，传入该参数会返回空数组
owned_by	string	按供应商过滤：openai / volcengine / kling / ali 等（以 GET /v1/models 返回的 owned_by 实际值为准）

请求示例

按类型筛选

curl "/v1/models?type=chat" \
  -H "Authorization: Bearer YOUR_API_KEY"

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="/v1"
)

resp = client.models.list(extra_query={"type": "chat"})
for m in resp.data:
    print(m.id)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "/v1",
});

const resp = await client.models.list({
  query: { type: "chat" },
});
for (const m of resp.data) {
  console.log(m.id);
}

按能力筛选（支持工具调用的 chat 模型）

curl "/v1/models?type=chat&capability=tools" \
  -H "Authorization: Bearer $TOKEN"

按供应商筛选

resp = requests.get(
    "/v1/models",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
    params={"owned_by": "zhipu"},
).json()

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "glm-5.2",
      "object": "model",
      "created": 1735660000,
      "owned_by": "zhipu",
      "type": "chat"
    },
    {
      "id": "glm-5.1",
      "object": "model",
      "created": 1735660000,
      "owned_by": "zhipu",
      "type": "chat"
    }
  ]
}

注意事项

• capability 可叠加：?capability=tools&capability=reasoning 表示同时具备两种能力。
• 筛选不返回任何结果时，data 为空数组，HTTP 状态仍为 200。
• type 与 capability 可组合使用。