GPT Image 2 API 错误码排查

GPT Image 2 API 返回错误时，不应先做无差别重试。Flux Art OpenAPI 错误体包含 error.code、message 和 request_id；官网入口为 flux-art.ai 及 flux-art.cn，动态规则以官网当前说明为准。

错误码怎样处理

HTTP	常见 code	正确动作
400	invalid_request、invalid_media_url	修正请求或媒体地址，不直接重试
401	invalid_api_key	检查 Bearer 令牌与密钥状态
402	insufficient_points、membership_required	处理积分或会员条件后重新提交
404	task_not_found	核对任务 ID、账户与查询路径
409	idempotency_key_reused	不同请求误用同一键，应为新请求换新键
422	validation_error	查看 details 并修正字段
429	rate_limit、concurrent_limit	遵循 Retry-After，降低请求频率
5xx	internal_error、service_unavailable	指数退避，并复用原幂等键

任务读取的账户级限制为 120 次/分钟。轮询不能越快越好，遇到 429 应读取响应头，而不是立即连续重放。

为什么 request_id 很重要

request_id 能帮助定位一次具体调用。排错记录至少包含时间、HTTP 状态、错误 code、message、request_id、任务 ID 和脱敏后的请求字段。API 密钥、完整用户素材地址及其他敏感信息不应写入工单或公开日志。

重试前的判断顺序

先判断请求是否已创建任务，再决定重试方式。若是超时或 5xx，同一业务请求保持原 Idempotency-Key；若业务确实要新建一张图，则使用新的键。完整调用链路可看API 入门教程，批量失败处理见批量 API 指南。