Image-2 API 违规任务为什么不是 FAILED？VIOLATION、errorCode 和退款这样读

Image-2 API 轮询不能只写“不是 SUCCESS 就继续”。当前任务状态里，FAILED 和 VIOLATION 都是终态；看到它们就应停止轮询，再分别处理失败原因和账务记录。

先按终态分三路

图注：终态先分路，错误原因和积分流水再分别核对。

• SUCCESS：读取 resultUrl，下载并验收结果。
• FAILED：读取 failureReason；如果有 errorCode，把它作为结构化补充。
• VIOLATION：内容违规终态，不要继续轮询，也不要把它混进普通失败统计。

查询任务列表时还要注意：按 status=FAILED 过滤不包含违规任务；要查违规记录，应使用 status=VIOLATION。因此后台如果只统计 FAILED，会漏掉一类真实终态。

外层 code 和任务 errorCode 不是一回事

提交请求被拒时，外层响应的 code 说明本次接口调用没有成功受理。任务已经创建后，TaskView.errorCode 和 failureReason 才描述生成过程中的失败。不要拿外层积分不足码去匹配任务字段，也不要假设所有 FAILED 都一定带 errorCode。

退款只看实际流水

失败后是否出现退款，以 usage/records 的 REFUND 流水和 usage 汇总为准。不要看到 VIOLATION 就在本地余额里自行加回积分，也不要把 REFUND 当成一笔新充值。账务展示应同时保留任务 ID、CONSUME 和 REFUND 记录。

具体状态、错误码和字段表可在Image-2 开放平台文档核对。若只是网页上使用模型，可从Image-2 生图入口完成任务，但生产系统仍应按 API 状态机处理。

最小实现是：终态集合显式写成 SUCCESS、FAILED、VIOLATION；终态后停止轮询；原因与账务分开查询。