Skip to main content
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

When status 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

Authorization
string
header
required

Use your APIPod API key as a Bearer token in the Authorization header.

Path Parameters

id
string
required

Task ID returned by the create endpoint.

Response

Task status snapshot

id
string
required

Task ID.

model
string
required

Public model family name used for this task.

status
enum<string>
required

Task status in Ark semantics.

Available options:
queued,
running,
succeeded,
failed,
cancelled
content
object

Output content. Present only after the task succeeds.

created_at
integer

Task creation time as a Unix timestamp in seconds.

updated_at
integer

Last status update time as a Unix timestamp in seconds.

error
object

Present only when the task failed.

usage
object

Final usage snapshot. Present only when the task succeeded.