模型列表

接入结论

• 端点：GET https://www.yuzhixiaolongxia.com/v1/models
• 认证：Authorization: Bearer <你的 API 令牌>
• 作用：返回当前令牌可以调用的模型列表，可作为令牌可用性 / 分组开放范围的探针
• 响应：标准 OpenAI 兼容格式，data[] 含 id、object、created、owned_by

用途

用途	说明
验证令牌	能正常返回列表就说明令牌有效、Bearer 解析通过、分组挂上了模型
动态拉取可用模型 ID	避免硬编码模型 ID；当平台增删模型时无需改代码
排查 404 model not found	把请求里的 model 字段和这里返回的 ID 对照，立刻能知道是不是拼写错
分组迁移	切换令牌后跑一次，确认目标模型是否在新分组开放

最小示例

TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.YZX_API_KEY,
  baseURL: "https://www.yuzhixiaolongxia.com/v1",
});

const models = await client.models.list();
for (const m of models.data) {
  console.log(m.id);
}

Python

from openai import OpenAI

client = OpenAI(
    api_key="你的令牌",
    base_url="https://www.yuzhixiaolongxia.com/v1",
)

for model in client.models.list().data:
    print(model.id)

curl

curl https://www.yuzhixiaolongxia.com/v1/models \
  -H "Authorization: Bearer $YZX_API_KEY" | python -m json.tool

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "claude-opus-4-7",
      "object": "model",
      "created": 1700000001,
      "owned_by": "system"
    },
    {
      "id": "claude-opus-4-6",
      "object": "model",
      "created": 1700000000,
      "owned_by": "system"
    },
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1700000002,
      "owned_by": "system"
    }
  ]
}

返回的模型 ID 是当前令牌所属分组实际开放的列表，而不是平台全部模型。

把它接进 CI / 启动检查

很多坑都来自"今天能用、明天发版后突然 404"。在服务启动时跑一次模型列表校验，能提前发现分组迁移问题：

import os
import sys
from openai import OpenAI

REQUIRED = {"claude-opus-4-7", "gpt-5.5"}

client = OpenAI(
    api_key=os.environ["YZX_API_KEY"],
    base_url="https://www.yuzhixiaolongxia.com/v1",
)

available = {m.id for m in client.models.list().data}
missing = REQUIRED - available
if missing:
    sys.exit(f"令牌分组缺少必需模型: {missing}")

常见问题

返回 401

令牌问题。检查环境变量是否被截断、是否含前后空格、是否已在管理后台禁用。

返回空 data 数组

令牌有效，但分组里没有任何已开放的模型。回管理后台把模型挪进分组，或换一个已挂模型的分组。

返回的列表比模型广场少

模型广场展示的是平台层面的全部模型；模型列表 API 返回的是当前令牌分组的开放范围。两者不一致是正常的，看分组配置即可。

我想知道模型的能力 / 价格

/v1/models 不返回价格，需要去 模型广场 查。

上一步：视频生成 | 返回：开发者 API 总览