故障排查 · 更新于 2026-10-03

模型不存在、无权限:名称与分组检查

有模型卡片不等于所有密钥都能调用,按名称、分组、渠道和协议逐项检查。

为什么广场有模型,客户端却说不能使用

模型广场显示的是本站配置的模型与分组,而 API 密钥只能使用它所属分组、且有权限的模型。有卡片并不意味着所有分组都已经接入。

按顺序检查

  1. 在广场选择密钥所属分组,确认模型显示已接入。
  2. 复制完整模型名称,注意短横线、点号和版本后缀;不要自行把名称改成另一种写法。
  3. 在密钥设置检查是否启用了模型范围限制,以及密钥是否过期、禁用或额度不足。
  4. 重新获取模型列表,确认返回列表中有目标模型。
  5. 核对客户端请求协议:Claude Code 使用 Messages;Codex 类客户端可能使用 Responses;普通聊天客户端常使用 Chat Completions。

站长需要检查的内容

后台选择的分组对应渠道分组。需要启用的渠道同时支持该模型,且上游实际接受该模型名称。

如果存在模型映射,确认映射后的名称与上游要求一致。别名不代表厂商官方型号或能力,不能仅凭名称判断支持情况。

如果价格和密钥配置正确,但上游返回模型无权限,应核对上游账号、渠道密钥的权限和上游模型列表。

求助时提供什么

提供发生时间、打码后的 Base URL、模型名、密钥分组、客户端版本和错误码。不要提交完整密钥。

查看模型分组

选择接口协议

管理 API 密钥