/v1/models 接口是什么，为什么它能验证一家中转站

它是什么

GET /v1/models 是 OpenAI 协议里的标准端点，用来列出「当前账号可用的模型」。

curl https://站点域名/v1/models -H "Authorization: Bearer 你的key"

返回结构：

{
  "object": "list",
  "data": [
    { "id": "gpt-4o", "object": "model", "owned_by": "openai" },
    { "id": "claude-sonnet-4-5", "object": "model", "owned_by": "anthropic" }
  ]
}

为什么它有价值

一、证明接口真的在转发

一个站可以做一个漂亮的落地页，声称支持几百个模型。但这不能说明任何事 —— 落地页只是文字。

而 /v1/models 必须真的连上上游才能返回清单。它需要真实的基础设施支撑。

二、暴露它实际提供的模型 id

各站对模型的命名不统一。同一个模型可能叫：

claude-sonnet-4-5 / claude-sonnet-4.5 / sonnet-4.5 / claude-4.5-sonnet

用 /v1/models 拿到的 id 是可以实际调用的那个，比文档上的名字可靠。

三、让「宣称」与「实际」可比对

本站的核心做法就是把两者分开：

两者不一致是正常的（宣传通常更乐观），但差距过大就值得留意。

三种返回及含义

关于 404：有些站刻意关闭这个端点，防止别人爬取它的模型清单。所以 404 不等于「假站」，但确实说明它的协议实现不完整，且你少了一个交叉验证的途径。

本站怎么用它

站点详情页「实测指标」里的「覆盖模型数」，来源就是这个端点的返回结果。

如果显示「—」，意味着我们没能从这个端点拿到清单 —— 不代表该站不支持那些模型，只代表我们没验证到。

你可以怎么用

接入前：

curl -s https://站点域名/v1/models -H "Authorization: Bearer 你的key" | head -c 500

• 能看到清单 → 协议实现较完整
• 404 → 可能在其他地方也缺功能，测试时要更充分
• 401/403（且 Key 正确）→ 一般正常

接入后：如果你要用的模型不在清单里，请求大概率会失败。先查清单，再去写代码。

一个注意点

模型清单里有，不等于你调用时一定成功。

清单说明「它注册了这个模型」，实际调用还取决于上游通道是否可用。清单是必要条件，不是充分条件。

相关阅读

• 给中转站做一次体检：20 分钟可完成的验证清单
• OpenAI 协议兼容：chat/completions 和 responses 的区别
• 可用率是怎么测出来的：本站的统计口径与局限