Get job status

Poll the status of an async generation job. Status transitions through pending → processing → completed or failed. When completed, the result object contains output URLs (see each endpoint’s documentation for the available keys).

We recommend waiting at least 5 seconds between polls. Choose a slightly different delay each time, for example between 5 and 6 seconds, to spread out requests when polling multiple jobs. Stop when the status reaches completed or failed.

Job status is available for up to 24 hours after the job reaches a terminal state, and can be removed sooner. Once a job is removed, this endpoint returns 404. Output URLs expire independently of job status; download or re-host outputs as soon as the job completes. See retention.