跳转到主要内容
含义： 请求参数无效，服务器无法处理请求。常见原因：
  • 请求体格式无效
  • 缺少必填参数
  • 参数类型不正确
  • 上下文长度超出模型限制
  • 第三方工具传入的参数格式不兼容
  • 视频生成参数不正确
  • 与 Codex 等工具的请求格式不兼容
解决方案：
  • 检查是否包含所有必填参数
  • 验证 JSON 格式是否有效
  • 压缩提示词和对话历史
  • 开始新对话重试
  • 检查视频生成参数，如 FPS、时长、分辨率和宽高比
  • 使用 Codex 等第三方工具时，检查并调整请求格式，或尝试其他 Agent
含义： 认证失败。请求未通过身份验证。常见原因：
  • API Key 不正确
  • API Key 已过期
  • API Key 配置不正确
  • 请求 Header 中缺少 Authorization 字段
  • API Key 属于其他账户
解决方案：
  • 检查 API Key 是否复制完整
  • 确认 API Key 仍然有效
  • 重新生成 API Key 并重试
  • 检查请求 Header 中是否正确包含 API Key
  • 确认 API Key 属于当前使用的账户
含义： 账户余额或可用配额不足以完成请求。常见原因：
  • 账户余额不足
  • Token Plan 配额不足
  • 当前请求超出可用配额
  • 订阅状态异常
  • 充值或订阅尚未生效
解决方案：
  • 检查账户余额
  • 检查 Token Plan 或订阅状态
  • 充值或升级套餐
  • 降低单个请求的成本，例如缩短上下文或降低图像/视频生成规格
  • 等待充值或订阅生效后重试
含义： 当前账户或 API Key 无权访问请求的资源。常见原因：
  • API Key 没有访问请求模型的权限
  • 账户未被授予访问请求模型的权限
  • 企业认证、订阅或权限状态尚未生效
  • 请求来源被安全规则阻止
  • IP 地址、地区或网络环境受到限制
解决方案：
  • 检查账户是否有权限访问该模型
  • 检查 API Key 是否属于正确的账户
  • 确认订阅或企业认证状态是否已生效
  • 尝试使用其他网络环境
  • 如果确认有权限但问题仍然存在，请联系技术支持
含义： 请求的 API 地址、路径或资源不存在。常见原因：
  • API 地址不正确
  • Base URL 配置不正确
  • 请求路径不正确
  • /v1 被第三方工具重复添加
  • 模型名称不正确
  • 请求的资源不存在
解决方案：
  • 检查 API 地址是否正确
  • 检查 Base URL 是否正确
  • 检查第三方工具配置中 /v1 是否被重复添加
  • 检查模型名称是否正确
  • 检查 API 路径是否遵循文档说明
含义： 当前 API 端点不支持正在使用的请求方法。常见原因：
  • HTTP 方法不正确
  • 需要 POST 时使用了 GET
  • 需要 GET 时使用了 POST
  • 第三方工具中的请求方法配置不正确
解决方案：
  • 查看 API 文档中所需的请求方法
  • 确认端点使用正确的方法，如 GET 或 POST
  • 更新第三方工具中的请求方法配置
  • 修改请求方法后重试
含义： 请求超时。服务器无法在允许的时间内完成处理。常见原因：
  • 本地网络不稳定
  • 请求内容过大
  • 上下文过长
  • 图像、视频或长文本任务处理时间过长
  • 客户端超时设置过短
解决方案：
  • 重试请求
  • 检查本地网络环境
  • 缩短输入内容或减少上下文长度
  • 降低图像或视频生成规格
  • 适当增加客户端超时设置
  • 为长时间运行的任务添加重试逻辑
含义： 请求与当前资源或任务状态冲突。常见原因：
  • 重复提交任务
  • 同一请求已在处理中
  • 当前资源状态不允许此操作
  • 第三方工具重复发送相同请求
解决方案：
  • 避免在短时间内重复提交相同请求
  • 等待当前任务完成后再重试
  • 检查任务状态
  • 在客户端添加重复提交保护
  • 如果任务已完成，先检查任务历史
含义： 请求体过大，服务器无法处理。常见原因：
  • 请求体过大
  • 输入上下文过长
  • base64 图像过大
  • 上传的文件或图像超出限制
  • 单次请求提交的内容过多
解决方案：
  • 压缩请求内容
  • 减少上下文长度
  • 分批提交内容
  • 减小上传的图像大小或分辨率
  • 对于图像，使用公共 URL 而不是发送大的 base64 数据
含义： 请求中的文件格式或 Content-Type 不受支持。常见原因：
  • 不支持上传的文件格式
  • 请求 Header 中的 Content-Type 不正确
  • 图像、音频或视频格式不符合 API 要求
  • 第三方工具自动设置了不正确的 Content-Type
解决方案：
  • 检查上传的文件格式
  • 确认 Content-Type 是否正确
  • 对于图像，使用 PNG、JPG、JPEG 或 WEBP 等常见格式
  • 对于音频或视频，使用 API 支持的格式
  • 转换文件格式后重试
含义： 请求格式有效，但参数值不符合模型或 API 要求。常见原因：
  • 参数值无效
  • 图像编辑参数异常
  • 视频生成参数异常
  • seed、分辨率、宽高比、FPS 或其他参数超出允许范围
  • 图生图请求中的图像 URL 无法访问
  • base64 格式无效
  • 图像或视频生成大小不符合要求约束
解决方案：
  • 查看错误消息中的具体参数提示
  • 检查图像或视频生成参数是否有效
  • 检查 seed 值是否在允许范围内
  • 检查图像 URL 是否可公开访问
  • 检查 base64 内容是否完整有效
  • 修改参数后重试
含义： 请求速率过高，超出当前账户的 RPM 限制。常见原因：
  • 超出 RPM 限制
  • 免费用户限制为 RPM 20
  • 并发请求过多
  • 短时间内重复请求过多
  • 自动重试频率过高
解决方案：
  • 等待 1 分钟后重试
  • 降低请求频率
  • 控制并发请求数量
  • 添加合理的重试机制
  • 避免短时间内重复请求
  • 如果请求量较大，升级到 Token Plan
含义： 请求 Header 过大，服务器无法处理。常见原因：
  • Header 中包含的内容过多
  • Authorization 信息异常
  • Cookie 或自定义 Header 过大
  • 第三方工具自动附加了过多 Header
解决方案：
  • 减小请求 Header 大小
  • 检查 Authorization 字段是否正确
  • 移除不必要的 Cookie 或自定义 Header
  • 在第三方工具中重新配置请求 Header
  • 更新 Header 后重试
含义： 客户端在请求完成前关闭了连接。常见原因：
  • 客户端超时断开连接
  • 浏览器或工具中断了请求
  • 本地网络切换或断开
  • 长时间运行的任务等待时间过长
  • 第三方工具提前取消了请求
解决方案：
  • 重新发送请求
  • 检查本地网络稳定性
  • 增加客户端超时设置
  • 任务运行时避免关闭页面或中断工具
  • 对于长时间运行的任务，使用异步任务或轮询
含义： 服务器遇到内部错误，或请求参数触发了服务异常。常见原因：
  • 请求参数异常
  • 图像生成大小不符合要求
  • 视频生成大小不符合要求
  • OpenClaw 中未配置 context 参数
  • 上游服务临时异常
解决方案：
  • 检查请求参数
  • 图像生成尺寸必须是 16 的倍数
  • 视频生成尺寸必须是 64 的倍数
  • 检查 OpenClaw 设置中的 context 参数
  • 修改参数后重试
  • 如果多次重试后问题仍然存在，将错误详情提交给技术支持
含义： 网关或代理未能从上游服务收到有效响应。常见原因：
  • 本地网络问题
  • DNS 解析问题
  • 代理配置问题
  • 网络连接不稳定
  • 上游服务临时波动
解决方案：
  • 检查本地网络环境
  • 尝试其他网络
  • 更改 DNS 设置
  • 检查代理配置
  • 稍后重试
  • 必要时，请 AI 或技术人员协助检查本地网络配置
含义： 服务暂时不可用，或由于第三方工具配置问题导致请求失败。常见原因：
  • 模型名称不正确
  • 获取模型列表失败
  • 未选择回退模型
  • 路由未启用
  • 第三方工具实际上将请求发送到了错误的模型
  • 服务暂时不可用
解决方案：
  • 检查模型名称是否正确
  • 重新获取模型列表
  • 选择一个回退模型
  • 启用路由
  • 检查第三方工具中的测试模型和备份模型设置是否配置正确
  • 稍后重试
含义： 网关等待上游服务响应时超时。常见原因：
  • 上游模型响应超时
  • 图像、视频或长上下文任务处理时间过长
  • 网络连接不稳定
  • 高峰时段服务负载高
  • 请求复杂度过高
解决方案：
  • 稍后重试
  • 缩短输入内容
  • 降低图像或视频生成规格
  • 减少并发请求
  • 适当增加客户端超时设置
  • 为长时间运行的任务添加重试逻辑
含义： 未知错误，通常与网络连接、网关行为或上游服务临时波动有关。常见原因：
  • 网络连接问题
  • 上游服务临时波动
  • 代理配置问题
  • DNS 配置问题
  • 网关返回了非标准错误
解决方案：
  • 重试请求
  • 检查本地网络环境
  • 检查代理配置
  • 检查 DNS 配置
  • 稍后重试
  • 如果问题持续存在，将完整错误消息提交给技术支持
含义： 网关连接上游服务时超时。常见原因：
  • 网络连接超时
  • 网关到上游的连接问题
  • 本地网络问题
  • 代理配置问题
  • DNS 配置问题
解决方案：
  • 重试请求
  • 检查本地网络
  • 检查代理配置
  • 更改 DNS 设置
  • 尝试使用其他网络环境
  • 稍后重试
含义： 连接已建立，但上游服务处理请求时间过长。常见原因：
  • 长上下文任务耗时过长
  • 图像生成任务耗时过长
  • 视频生成任务耗时过长
  • 服务负载高
  • 请求复杂度过高
解决方案：
  • 稍后重试
  • 降低请求复杂度
  • 缩短上下文
  • 降低生成规格
  • 减少并发请求
  • 对于长时间运行的任务，使用异步任务或轮询