错误与幂等
标准错误、重试、限流和防重复提交。
错误使用 application/problem+json 和真实 HTTP 状态码，并带 request_id。
创建请求必须使用 8-128 位 Idempotency-Key。服务端只保存 Key 的 HMAC 和请求指纹：相同 Key/请求返回原任务；相同 Key/不同请求返回 409 idempotency_conflict；原请求仍在处理时返回 409 request_in_progress。
常见错误包括 invalid_api_key、invalid_api_key_rate_limited、api_key_expired、insufficient_scope、validation_error、unsupported_model、unsupported_parameter、input_url_not_allowed、insufficient_credits、payment_required、real_person_not_enabled、rate_limit_exceeded、concurrency_limit_exceeded 和 service_unavailable。
同一客户端 IP 连续提交无效凭证也会被限流。服务只保存经过 Pepper HMAC 处理的 IP 指纹；超过配置阈值后返回 invalid_api_key_rate_limited 和 Retry-After。
网络错误、429 和 503 可退避重试，但请求体和幂等 Key 必须完全不变。Provider 结果无法确认时，接口会拒绝盲目重提。