TiDBA API

为什么 /v1/models 有模型,调用却提示 model_not_found?

模型名被列出、当前 Key 有权限、该模型支持所用接口、上游此刻可调度,是四个不同条件。先保存原始模型名和错误详情,不要直接改写成旧模型。

更新于 2026-10-08阅读约 4 分钟

四步定位

  1. 把请求 JSON 中的 model 与列表中的 ID 逐字比较,注意空格、大小写和客户端本地别名。
  2. 确认此模型支持你调用的接口与功能;能用于 Responses,不代表一定能用于 Chat Completions 或某个客户端。
  3. 官方 API 要核对所属项目和模型权限;本站要核对 Key 所属分组及该组当前可用的模型。
  4. 若同一模型的短请求偶尔成功、偶尔失败,记录 Request ID 与时间,按路由或上游容量问题继续排查。
curl -sS https://sub.tidba.com/v1/models \
  -H "Authorization: Bearer $TIDBA_API_KEY"

列表是发现线索,不是可用性承诺。上游容量不足也可能表现为 503 或其他错误,参见 模型容量排查。

客户端与网关各看什么

客户端可能缓存了过期模型目录。先重启客户端、刷新模型列表,再以同一 Key 发送最小请求。若平台记录了请求但没有选中账号,应由平台核对调度;若请求根本没到平台,检查 Base URL 和接口路径。切换模型只能作为诊断对照,不应冒充原模型继续处理业务。

官方依据

OpenAI 官方文档:Errors and recovery 对 model_not_found 的建议是核对 ID、模型与项目。本站的分组和调度属于独立兼容服务,需要结合站内记录判断。

保留精确模型名

同时提供 Request ID,才能定位实际失败层级。

检查接口路径