错误码

请求错误

请求失败时返回非 2xx 状态码：

{
  "error": {
    "code": "invalid_request",
    "message": "image 必须是 http(s) URL 或 base64 图片",
    "request_id": "req_8fK2mQ9xZ1aB3cD5eF7g"
  }
}

程序判断请使用 code，message 仅用于提示。

HTTP	code	说明
400	invalid_request	参数错误、模板不存在、图片无法读取
401	invalid_api_key	Key 无效、已禁用或已过期
402	insufficient_balance	点数不足，任务未创建，见计费与点数
403	forbidden	IP 不在白名单，或账号已禁用
404	not_found	任务不存在
422	input_rejected	未检测到清晰人脸，或疑似未成年人
429	rate_limited	超过每分钟请求数
429	concurrency_limited	进行中的任务数达到上限
500	internal_error	服务器错误
503	upstream_unavailable	生成服务暂不可用
503	moderation_unavailable	审核服务暂不可用

429、500、503 可以稍后重试，其余请检查请求后再提交。

任务失败原因

任务状态为 failed 时，error.code 为：

code	说明
generation_failed	生成失败，可重试或更换图片
empty_output	未返回结果，可重试
output_rejected	结果未通过内容审核
timeout	超过 15 分钟未完成