Query video generation task
Tasks
Query video task (Ark-compatible)
Poll the status of an asynchronous video generation task created through the Volcano Ark-compatible endpoint.
GET
Query video generation task
Poll this endpoint with the task
id returned by the create endpoint until the task reaches a terminal state. For production workloads, prefer callback_url on the create request over tight polling loops. Task records are retained for the same window as native APIPod tasks; download or persist the video URL promptly once the task succeeds.
Task statuses
Usage and cost
Whenstatus is succeeded, the response includes a usage object with the final amount charged for the task. cost is the settled amount in USD after any post-completion adjustment and matches the cost shown in the dashboard; it is an APIPod extension to the Ark contract and is always present. Token fields appear only when the upstream provider reports token usage.
A task that is not found, or that belongs to another account, returns 404 without distinguishing the two cases.Authorizations
Use your APIPod API key as a Bearer token in the Authorization header.
Path Parameters
Task ID returned by the create endpoint.
Response
Task status snapshot
Task ID.
Public model family name used for this task.
Task status in Ark semantics.
Available options:
queued, running, succeeded, failed, cancelled Output content. Present only after the task succeeds.
Task creation time as a Unix timestamp in seconds.
Last status update time as a Unix timestamp in seconds.
Present only when the task failed.
Final usage snapshot. Present only when the task succeeded.