Get generation job status
Returns the current status and result of a generation job. For async operations (stories), poll this endpoint until status is “completed” or “failed”.
The scenes_completed and scenes_total fields track progress for story generation. When status is “completed”, the result field contains the full generation output including signed image URLs.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”Job UUID.
Job UUID.
Responses
Section titled “ Responses ”OK
object
UTC timestamp when the job finished (completed or failed). Omitted if pending.
UTC timestamp when the job was created.
Error details. Present only when status is failed.
object
Machine-readable error code. Story jobs: model_refused (the model returned no image), upstream_error (the model rejected the request; retrying it unchanged fails), upstream_unavailable (the model was unavailable), generation_failed, post_generation_failed (an image was generated but could not be finished), service_unavailable (the story could not start in time), timeout (the story ran past the maximum time), internal_error, story_generation_failed. Single-image jobs: generation_failed, post_generation_failed, output_withheld (our check of the generated image withheld it; you were not charged), output_check_unavailable (the check of the generated image could not run; you were not charged). Any job: abandoned (it never finished), delivery_failed (generated and charged, but not delivered). message says what happened and what to do.
Human-readable description of why the job failed.
Unique async job identifier.
Full generation result (same shape as synchronous create response, so cost_eur is in credits (EUR, excluding VAT)). Present only when status is completed.
Number of scenes that have been generated so far.
Total number of scenes requested.
UTC timestamp when processing began. Omitted if not yet started.
Job status: pending, processing, completed, or failed.
Bad Request
object
Unauthorized
object
Payment Required
object
Forbidden
object
Not Found
object
Conflict
object
Unprocessable Entity
object
Too Many Requests
object
Unavailable For Legal Reasons
object
Internal Server Error
object
Bad Gateway
object
Service Unavailable