小工具

API 端点自测命令生成器:三条 curl 验证模型清单、协议和可用性

买 Claude Code 或 Codex 接入服务之前,或者配置后一直报错时,填入端点地址和 Key,生成三条可以直接粘贴的 curl 命令:列出端点真实支持的模型,用错误 Key 判断是否为原生协议,发一个最小请求验证模型能调通。支持 Anthropic 与 OpenAI Responses 两种协议,在浏览器本地生成。

核实于 2026-11-03 · 更新于 2026-11-03
一句话结论

三条命令依次回答三个问题:这个端点支持哪些模型(GET /v1/models)、它是不是原生协议(用错误的 Key 看状态码,Anthropic 端点应返回 401,而 /v1/chat/completions 应返回 404)、模型能不能真的调通(发一个只要求回复 OK 的最小请求)。

命令格式与判读规则来自本站选型知识库《怎么查一个 API 端点支持哪些 Claude 模型》;请求路径和请求头已在 2026-11-03 用 Claude Code 2.1.312、Codex CLI 0.166.0 抓包核对:前者请求 /v1/messages,后者请求 /v1/responses。

填根地址,不带 /v1。
① 列出端点真实支持的模型

          
② 用错误 Key 判断协议是不是原生的

          
③ 最小请求,验证模型真能调用

        

为什么要自己测

服务商的页面怎么写都可以,命令的返回结果作不了假。这三条命令覆盖了接入前最该确认的三件事:

命令 回答的问题 合格的样子
① 列模型 宣传的模型是不是真的有 返回 JSON 列表,里面有你要用的模型 ID
② 错误 Key 是原生协议,还是别的协议套了一层 Anthropic:/v1/messages 返回 401,/v1/chat/completions 返回 404
③ 最小请求 模型能不能真的调通 返回一段包含 OK 的正常响应

读懂第②条的结果

用一个故意写错的 Key 去请求,401 是好结果:说明这个路径存在,而且服务端认真校验了 Key。真正需要警惕的是两种情况:

  • 错误 Key 也返回 200:鉴权形同虚设。
  • Anthropic 路径返回 404、OpenAI 路径返回 200:这根本不是 Anthropic 协议,Claude Code 连不上。

顺便看一眼错误响应体的格式。原生 Anthropic 的错误是 {"type":"error","error":{"type":"authentication_error",...}} 这种结构,字段对得上,说明不是临时拼凑的转换层。

第③条的模型 ID 从哪抄

只从第①条的返回里抄,不要照搬文档或别人博客里的写法。模型 ID 写错是 404 最常见的原因:同一个模型在不同服务方那里的 ID 可能不一样,带不带日期后缀、带不带前缀都有区别。

Windows 怎么跑

生成的是 bash 语法的命令。Windows 用户可以在 Git Bash 或 WSL 里运行;PowerShell 对引号的处理和 bash 不同,直接粘贴进去 JSON 会被拆坏。只想验证 Claude Code 的配置,可以用 Claude Code 配置生成器,它会按 PowerShell 和 CMD 分别生成。

Key 会不会泄露

不会离开你的浏览器。命令在本地 JavaScript 里拼接,页面不会把输入发往任何服务器。命令里会带上明文 Key,分享截图或贴到群里之前记得把它删掉。

常见问题

第①条返回空列表或 404 怎么办?

部分服务方没有开放 /v1/models。这不一定说明端点不能用,但你就没法自行核对模型清单了,只能看第③条能不能调通。能提供模型清单接口的服务,透明度更高。

第③条返回 400 是什么情况?

看返回体里的 message。最常见的是模型 ID 不对,其次是额度用完(会写明重置时间)。如果是 prompt is too long,说明请求超过了模型上下文上限,最小请求一般不会遇到。

测通了,Claude Code 里还是报错?

那问题多半在本地配置上:变量没生效、写错了配置文件、地址多写了 /v1。用配置生成器重新生成一遍,再对照 Not logged in 排查。