API 报 403 是什么原因？模型权限、Key 权限和分组配置排查
用户侧排查步骤
- 确认报错不是
invalid_api_key（如果是，先重新生成 Key） - 确认调用的模型名正确（大小写、空格都要匹配）
- 确认令牌绑定的分组包含该模型
- 联系站长确认渠道和分组配置
站长侧排查步骤
- 检查分组是否绑定了对应模型
- 检查渠道是否启用目标模型
- 检查令牌是否绑定到正确的分组
- 检查渠道是否被禁用
403 和 invalid_api_key 的区别
| 错误 | 含义 | 主要处理方向 |
|---|---|---|
invalid_api_key | Key 在这个 Base URL 上无效 | 重新生成 Key，或检查 Base URL 配置 |
403 Forbidden | Key 有效，但无目标模型权限 | 检查分组、渠道和模型绑定配置 |
用户侧排查
第一步：确认不是 invalid_api_key
如果报错是 invalid_api_key，先按 invalid_api_key 排查指南 处理，再排查 403。
第二步：确认模型名正确
模型名必须与渠道支持的名称完全匹配（注意大小写、空格）：
claude-opus≠claude Opus≠Claude-Opusgpt-5.5≠GPT-5.5- 确认模型名在渠道中已启用
第三步：检查令牌分组
如果你是站点用户（不是站长），请联系站点管理员确认你的令牌绑定的分组包含目标模型。
第四步：确认余额
部分站点余额耗尽后会拒绝请求（可能表现为 403 或 429）。
站长侧排查（New API / One API）
检查分组是否绑定了模型
在 New API 后台 → 分组管理 → 编辑分组 → 绑定模型，确认目标模型已在分组中。
检查渠道是否启用模型
在渠道管理中，确认目标模型已启用。没有启用 = 无法调用 = 403。
检查令牌是否绑定到分组
在令牌管理中，确认令牌绑定了正确的分组，分组里包含目标模型。
检查渠道是否被禁用
如果渠道被禁用，所有通过该渠道的请求都会返回 403。
检查模型名映射
New API 支持模型名映射。如果请求的模型名与渠道绑定的模型名不匹配，会返回 403。
常见 403 原因汇总
| 场景 | 用户侧原因 | 站长侧原因 |
|---|---|---|
| 所有模型都报 403 | Key 有效但无任何权限 | 分组没有绑定任何模型 |
| 部分模型报 403 | 该模型不在分组绑定列表中 | 分组没有绑定该模型，或渠道没有启用 |
| Claude Opus 报 403 | Opus 渠道没有启用 | Opus 渠道被禁用或没有额度 |
| 换模型后 403 | 新模型不在分组绑定列表中 | 分组没有绑定新模型 |
和 Link-AI 有什么关系？
Link-AI 是 OpenAI-compatible API gateway，面向开发者提供 Claude、GPT 等模型接入服务。
- 403 错误通常不是 Link-AI 本身的问题，而是分组/渠道/模型绑定配置问题
- 如果遇到 403，可以联系客服提供具体错误信息和模型名
- 如果担心扣费异常，使用 API 扣费检测工具
常见问题
403 表示请求被服务端拒绝，通常原因是 Key 没有目标模型的调用权限。可能包括分组没绑定模型、渠道没启用模型、令牌没权限、模型名错误等。
New API 的分组是权限管理单位。如果分组里没有绑定某个模型，即使 Key 有效也无法调用该模型，会报 403。需要站长在后台将模型绑定到分组。
渠道需要在后台启用对应模型才能使用。如果渠道没有启用目标模型，New API 会返回 403。需要站长在渠道设置中启用模型。
1) 确认 Key 有效（不是 invalid_api_key）；2) 确认调用的模型名正确（大小写、空格都要匹配）；3) 确认令牌绑定的分组包含该模型；4) 联系站长确认渠道和分组配置。
1) 检查分组是否绑定了对应模型；2) 检查渠道是否启用目标模型；3) 检查令牌是否绑定到正确的分组；4) 检查用户余额是否充足；5) 检查渠道是否被禁用。
会。如果调用的模型名与渠道绑定的模型名不匹配（如大小写、空格差异），New API 可能返回 403。请确认模型名与渠道实际支持的名称一致。