Skip to main content
GET
Retrieve an asset generation

Authorizations

Authorization
string
header
required

Your API key, as a Bearer token: Authorization: Bearer <key>.

Path Parameters

asset_id
string
required

The asset generation's id, from POST /assets's response.

Response

Successful Response

A single generation's full detail: everything in a list item plus its downloadable result and the credits charged.

id
string
required

The generation's unique identifier.

status
string
required

One of pending, processing, completed, failed, cancelled.

created_at
string<date-time>
required

When the generation was submitted (UTC). Subtract from the current time to see how long the generation has been in the system.

config
GenerationConfig · object
required

The config this generation ran with, including any defaults applied when you omitted them.

name
string | null

The generation's display name.

project_id
string | null

The project this generation's assets live under.

status_reason
string | null

Detailed, human-readable reason for the generation's current status. On failed it begins with a stable machine-readable code (the text before the first :) then detail, e.g. REFERENCE_FETCH_FAILED: could not fetch reference url (404); codes are REFERENCE_FETCH_FAILED, IMAGE_UNSUPPORTED_TYPE, TIMEOUT, DISPATCH_FAILED, MISSING_CREDENTIALS, NO_DELIVERABLE, THUMBNAIL_CREATE_FAILED, INTERNAL. May also carry a lifecycle note such as preempted. null when the status needs no elaboration.

completed_at
string<date-time> | null

When the generation reached its final status (UTC), set for completed, failed, and cancelled alike. Subtract created_at for the generation's end-to-end wall time, including queue wait. null while the generation is still pending or processing.

result
AssetGenerationResult · object | null

Downloadable output files, present only when status is completed.

credits_charged
number | null

Credits charged for this generation: the fixed price reserved at submission. A cancelled generation stays charged this price; cancelling is not a refund. Present on POST /assets, GET /assets/{id}, and POST /assets/{id}/cancel; null when nothing is currently charged, which covers a failed generation (refunded) and a generation that was never charged. List entries always omit it.