IMAGE_GEN_FAILED

HTTP status: 502

What it means

AI image generation failed for an image element.

Why it happens

• AI image generation for a generate block failed upstream.

How to fix it

• Retry — transient model failures happen.
• Simplify very long prompts (folded prompt must stay under 1024 characters).

Example

Every non-2xx response uses the same envelope; path (when present) is the exact JSON path of the offending field, and requestId identifies the request in support conversations:

{
  "error": {
    "code": "IMAGE_GEN_FAILED",
    "message": "AI image generation failed.",
    "docsUrl": "https://automotion.dev/docs/errors/image_gen_failed"
  },
  "requestId": "req_0123456789abcdef0123456789abcdef"
}

See the error index for the full catalog and the API overview for envelope semantics.