Poll story generation status
GET /v1/generate/story/{id}
Poll the status of an async story generation. Returns the current status, progress (scenes_completed / scenes_total), and the result when complete.
GET /v1/jobs/{id} returns the same data for story jobs. This endpoint exists so the poll URL in the 202 response is self-documenting.
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 (e.g. content_rejected, insufficient_credits).
Human-readable description of why the job failed.
Unique async job identifier.
Full generation result (same shape as synchronous create response). 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