错误排查

model not found 与 /v1/v1 错误排查

解决大模型 API 中的模型不存在、模型展示名误用、Base URL 重复拼接、404 与接口路径错误。

更新于 2026-07-11 预计阅读 6 分钟 适用于 OpenAI Compatible API

model not found/v1/v1 都属于配置型错误。反复充值、重建 Key 或提高重试次数通常没有用,应该先核对模型 ID 和最终请求地址。

开始前检查

记录客户端实际发送的完整 URL 和模型字段。不要只看设置页面里填写了什么,因为客户端可能会自动追加路径或替换模型别名。

配置步骤

获取真实模型 ID

curl https://www.aifast.club/v1/models \
  -H "Authorization: Bearer $AIFAST_API_KEY"

从返回结果复制 id 字段。以下内容通常不能直接当模型 ID:

  • 网页卡片标题。
  • 中文模型名称。
  • 厂商名称。
  • “最新”“旗舰”“高速”等营销标签。

检查最终 URL

正确的 Chat Completions 请求通常类似:

https://www.aifast.club/v1/chat/completions

错误示例:

https://www.aifast.club/v1/v1/chat/completions
https://www.aifast.club/chat/completions
https://www.aifast.club/v1/models/chat/completions

如果客户端自动追加 /v1,Base URL 就填写根域名;如果客户端要求完整兼容地址,则保留 /v1

常见问题

模型列表里有,但调用仍然不存在

模型可能只支持特定接口或当前账号权限不同。核对模型是否支持 Chat Completions、Responses、图像或视频任务,不要用文本接口调用非文本模型。

404 返回的是网页 HTML

说明请求可能落到了前端站点,而不是 API 路由。检查 Host、路径和反向代理,不要把 HTML 错误页当作模型返回。

工具自动把模型名改掉

部分客户端只允许内置模型或会把显示名称映射到固定 ID。查看请求日志确认最终发送值;必要时使用客户端提供的自定义模型功能。

下一步

修正模型名和地址后,用非流式短请求验证。短请求成功后,再恢复工具调用、长上下文和流式输出。

准备开始调用?

创建 API Key,按本文配置直接验证

注册后可在控制台查看可用模型、用量和请求记录。

注册使用 查看 API 文档