Poll story generation status
Poll the status of an async story generation. Returns the current status, progress (scenes_completed / scenes_total), and the result when complete.
It returns the same data as GET /v1/jobs/{id}, which poll_url in the 202 response points to. Either endpoint can be polled.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”Story job UUID.
Story 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