Skip to main content
GET
/
api
/
v3
/
contents
/
generations
/
tasks
/
:task_id

Authorization

  • Auth Type: Bearer Auth (In: header)
  • Format: Authorization: Bearer <YOUR_API_KEY>
  • Description: Use Bearer <YOUR_API_KEY>. Format: Authorization: Bearer sk-xxxxxx.
  • API Key: where API Key is your AGCloud API KEY

Path Parameters

task_id
string
required
The processing task ID.

Field Description

FieldTypeDescription
idstringTask identifier (same value as result.task_id from the create task response when present).
modelstringModel used for generation.
statusstringTask lifecycle status (e.g. queued, pending, running, succeeded, failed, expired, cancelled).
contentobjectResult payload when the task completes; shape may vary by status.
content.video_urlstringURL of the generated video when status indicates success.
usageobjectToken usage for this task.
usage.completion_tokensintegerTokens attributed to completion / output.
usage.total_tokensintegerTotal tokens counted for billing or reporting.
created_atintegerTask creation time (Unix timestamp).
updated_atintegerLast update time (Unix timestamp).
seedintegerRandom seed used for this generation when applicable.
resolutionstringOutput resolution (e.g. 720p).
ratiostringOutput aspect ratio.
durationintegerVideo duration in seconds.
framespersecondintegerFrame rate used for encoding.
service_tierstringService tier applied to the task.
execution_expires_afterintegerTask execution expiry window from creation (seconds), when returned.
generate_audiobooleanWhether audio output was requested.
draftbooleanWhether generation ran in draft mode.