Skip to navigation
PlatformAI Generation

Media · Generate · Poll a video generation job (step 3 of 3)

View as Markdown

Step 3 — poll this endpoint after generateVideo. Read job_status:

  • Non-terminal: CREATED, PENDING, PROCESSING, RENDERING, UPDATED — keep polling. 10s is a reasonable interval.
  • Terminal: DONE (success — payload.output and asset_references are now populated with the rendered video URL) or FAILED (error — inspect payload.errors).

Generation is webhook-driven (FAL / Kie call back into djapp when rendering finishes), so the row updates asynchronously — there is no task_id to short-circuit polling.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

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

Path parameters

art_idstringRequired

AiImageArt UUID returned as id from generateVideo.

variation_idstringRequired

AIArtVariation UUID returned as art_variation_id from generateVideo.

Response

AIArtVariation record.
idstringOptional
AIArtVariation UUID.
job_statusenumOptional

Lifecycle state of an async generation job. Terminal: DONE (success), FAILED (error). All other values are non-terminal — keep polling.

modifieddatetimeOptional
payloadmap from strings to anyOptional

Variation payload. Key sub-fields:

  • input — the request that produced this variation (model, capability, and all parameter values).
  • output — populated once job_status="DONE"; contains the generated asset references / URLs.
  • errors — populated on job_status="FAILED".
  • reserved_quota_id — internal credit reservation marker.
outputmap from strings to anyOptional

Convenience expansion of payload.output with resolved asset URLs. Populated only when job_status="DONE".

Errors

401
Unauthorized Error
404
Not Found Error