常见错误码与失败原因

常见错误码与失败原因

页面提示可能来自浏览器、Helio 后端、支付系统或上游模型服务。实际提示文案会随版本调整，以下用于快速定位问题。

通用 HTTP 状态

状态码	常见含义	用户建议	客服排查
400	请求参数错误	检查输入内容后重试	查看请求参数、前端版本和接口日志
401	登录失效或未登录	重新登录	确认 token 是否过期或账号状态是否异常
403	无权限	确认账号权限或套餐	检查账号状态、套餐、后台权限配置
404	资源不存在	刷新页面或返回上一页	检查会话、订单、任务 ID 是否存在
409	状态冲突	不要重复提交，刷新后重试	检查是否重复支付、重复申诉或任务状态已变化
422	内容或参数不支持	调整提示词、图片或参数	检查模型能力配置和内容审核结果
429	请求过快或并发过高	稍后重试	查看限流、并发和任务队列
500	系统内部错误	稍后重试并联系支持	查看后端错误日志和链路追踪
502/503	上游服务异常	稍后重试或切换模型	检查上游模型、支付或存储服务状态
504	请求超时	降低复杂度后重试	查看任务耗时、上游超时和网络链路

业务错误

错误类型	含义	处理建议
INSUFFICIENT_CREDITS	积分不足	充值后重试，或选择消耗更低的模型
MODEL_UNAVAILABLE	模型不可用	切换模型或稍后重试
MODEL_CAPABILITY_MISMATCH	参数不被模型支持	调整比例、分辨率、时长或参考图数量
CONTENT_POLICY_REJECTED	内容可能不符合规则	修改提示词或素材，避免敏感、违法或侵权内容
UPLOAD_FAILED	参考图或凭证上传失败	检查文件大小、格式和网络
TASK_TIMEOUT	生成任务超时	稍后重试，降低分辨率、数量或时长
PAYMENT_PENDING	支付结果尚未确认	等待轮询，或稍后在订单列表查看
ORDER_EXPIRED	订单超时	重新创建订单并支付
DUPLICATE_APPEAL	已存在处理中的申诉	等待处理完成，不要重复提交

图片生成失败

常见原因：

• 提示词为空或过短。
• 参考图格式不支持、文件过大或仍在上传。
• 当前模型不支持图生图。
• 比例、分辨率或数量超出模型能力。
• 上游模型排队、超时或返回失败。
• 内容触发安全策略。

处理建议：

1. 缩短提示词并明确主体。
2. 降低分辨率或生成数量。
3. 移除参考图后重试。
4. 切换同类模型。
5. 保留失败任务截图和时间，提交客服。

视频生成失败

常见原因：

• 提示词缺少动作描述。
• 时长、比例或分辨率不被模型支持。
• 参考图和提示词冲突。
• 视频任务排队时间过长。
• 上游视频服务超时。

处理建议：

1. 增加动作和镜头描述。
2. 缩短时长或降低分辨率。
3. 使用更清晰、主体更单一的参考图。
4. 避免多人、复杂手部、快速运动和密集文字。

联系支持时请提供

• 账号邮箱或用户 ID。
• 操作时间。
• 页面入口，例如对话、图片生成、视频生成、充值。
• 模型名称。
• 错误提示截图。
• 订单号、任务 ID 或会话 ID。