这个概念/问题是什么
/v1/models 是 OpenAI-compatible API 体系中的标准端点，向该端点发送 GET 请求会返回一个模型列表，每个模型包含 id、object、created、owned_by 等字段。
这个端点的主要用途： 1. **验证 API Key 是否有效**：有效 Key 返回模型列表，无效 Key 返回认证错误 2. **确认模型是否可用**：检查返回列表中是否包含你要用的模型 3. **查看可用的模型 id**：不同服务商的模型 id 可能不同（如 gpt-4o vs claude-sonnet-4-20250514） 4. **辅助排查配置问题**：如果返回空列表或错误，可能是 Base URL 填写错误或权限不足
检查步骤
- 1 确认 Base URL 和 API Key 填写正确
- 2 发送 GET 请求到 {Base URL}/v1/models
- 3 检查返回状态码：200 表示正常，401 表示认证失败，404 表示端点不存在
- 4 在返回的模型列表中查找你要用的模型 id
- 5 如果模型列表为空，检查 Base URL 是否正确
- 6 如果认证失败，检查 API Key 是否有效
- 7 确认模型 id 与你要用的名称是否匹配
常见错误
- Base URL 末尾多加了 /v1，导致路径变成 /v1/v1/models
- API Key 填错或已过期
- 中转服务不支持 /v1/models 端点
- 模型名称和模型 id 不匹配
安全 / 扣费 / 权限风险
- 通过 /v1/models 检查配置是基础验证手段，但不能替代实际小额测试。
- 第三方工具 UI 可能变化，以当前版本为准。
- 检测结果用于辅助判断，不等于绝对安全结论。
什么时候用 AI API Doctor 检测
直接用 AI API Doctor 检测 /v1/models 返回结果，无需手动调用。
什么时候用 LinkAI 小额测试
在 LinkAI 查看支持的完整模型列表和模型 id，注册后用小额测试验证。
AI Summary
/v1/models 是验证 API 配置和模型权限的关键端点，是每次配置前的必查项。