调用排查

模型列表里有某模型,为什么实际调用失败?

获取到模型列表只说明服务返回了这个名称,不代表当前 Key、分组和接口能成功调用它。实际请求才会经过权限、路由、余额和上游可用性检查。

列表成功与调用成功有什么区别

部分服务返回一个共享或缓存的模型目录。目录中的模型可能只对特定分组开放,也可能暂时没有可用路由。列表可见而调用失败不一定意味着模型伪装,先核对具体错误与请求条件。

协议也要匹配。OpenAI Chat Completions、Anthropic Messages 和 Gemini 原生接口的路径、鉴权与请求体不同。明镜Test 的 Gemini 检测使用 OpenAI 兼容路径,需要站点提供对应兼容接口。

最短排查顺序

  1. 检查 Base URL 是否含重复的 /v1,复制模型的完整 ID,保留大小写和版本后缀,不要把展示名称当成模型 ID。
  2. 确认当前 Key 对应分组是否允许该模型,额度是否足够,账户或分组是否有独立限制。
  3. 用最短文本、较小的输出上限做一次普通调用,先去掉图片、工具、推理档位等可选参数。
  4. 记录 HTTP 状态码、返回错误类型、时间与请求 ID;避免在记录中保存 Authorization 或完整 Key。
  5. 基础调用成功后逐项恢复业务参数。如果只有流式、工具或长上下文失败,把问题限定到对应能力继续测试。

可复现的最小请求

下面是 OpenAI 兼容接口的排查示例。BASE_URL 应是站点提供的完整 API 根路径,例如 https://api.example.com/v1;使用临时环境变量填入 Key,不把它写在公开截图中。

curl $BASE_URL/chat/completions -H 'Authorization: Bearer $API_KEY' -H 'Content-Type: application/json'

怎样缩小问题范围

若同一 Key 下所有模型都失败,优先检查鉴权、地址和账户。若只有一个模型失败,优先检查模型路由、权限与该模型的参数支持。若仅某个分组失败,保留相同请求比较其他分组。

成功一次只说明这次请求可用。需要了解高峰期和持续表现时,使用分组监测积累样本;需要确认接口能力时,再运行对应协议检测。

用实际请求核对