Skip to main content
GET
Query Image Task Status

Get Task Status

Query the execution status of image generation and editing tasks and retrieve generated images when complete.

Endpoint

Authentication

All requests require Bearer token authentication:

Parameters

Path Parameters

Response

Success Response (200)

Response Fields

Status Values

Failed Task

Code Example

Important Notes

Poll Interval: Check status every 2-5 seconds. Typical image generation takes 15-60 seconds.
Content Validity: Generated images are accessible for 3 days after creation. Download and save your content promptly.
Webhooks: Instead of polling, you can provide a callback_url when submitting tasks to receive automatic notifications. See Image Webhook Callbacks.
For code samples in more languages, polling with backoff, and HTTP error codes, see the unified task status page.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

task_id
string
required

Unique task identifier returned from the submit endpoint

Response

200 - application/json

Task status

code
integer
required
Example:

200

data
object
required
Example: