403 Forbidden

403 Forbidden 表示服务器理解了请求，但拒绝执行。与 401 不同，403 意味着身份验证已通过，但没有权限执行该操作。

错误示例

{
  "error": {
    "message": "Access denied",
    "type": "permission_denied",
    "code": "forbidden"
  }
}

原因分析

原因	说明
Key 无权限访问该模型	Key 的模型权限列表中不包含目标模型
IP 被限制	Key 或账户设置了 IP 白名单，当前 IP 不在其中
模型无权限	目标模型需要特定的权限等级或套餐
Key 权限不足	Key 被限制了请求类型（如只读、不能调用特定接口）

排查步骤

1. 确认是否为模型权限问题

使用 Models 接口查看当前 Key 可用的模型：

curl "$BASE_URL/v1/models" \
  -H "Authorization: Bearer $API_KEY"

检查返回的模型列表中是否包含你要调用的模型名称。

2. 确认是否为 IP 限制问题

1. 查看你的公网 IP：

   curl -s ifconfig.me

2. 在管理后台检查 Key 或账户是否设置了 IP 白名单

3. 确认你的 IP 是否在白名单中

3. 确认是否为 Key 权限不足

1. 在管理后台查看 Key 的权限设置
2. 检查 Key 是否被限制了可用的接口类型
3. 确认 Key 的角色和权限等级

解决方案

Key 无权限访问模型

1. 在管理后台进入 API Key 管理 页面
2. 编辑对应的 Key
3. 在模型权限设置中，添加目标模型或选择「所有模型」
4. 保存后重新尝试请求

IP 被限制

1. 在管理后台找到 IP 白名单设置
2. 将你的公网 IP 添加到白名单中
3. 如果不确定 IP 是否固定，可以暂时清空白名单（不限制 IP），但请注意安全风险

模型需要更高权限等级

1. 在管理后台查看当前套餐和权限等级
2. 联系管理员升级套餐或开通目标模型的使用权限
3. 或者使用你有权限的替代模型

Key 权限不足

1. 在管理后台查看 Key 的角色和权限
2. 如果 Key 是子 Key，检查其继承的权限范围
3. 创建一个具有完整权限的新 Key，或联系管理员调整权限