Retrieve video task

Request format, responses, and capability boundaries.

200

{
  "id": "task_example",
  "object": "video",
  "model": "YOUR_MODEL_ID",
  "status": "queued",
  "progress": 0,
  "created_at": 1700000000
}

GET /v1/videos/{task_id}

task_id is the gateway id returned by creation. Use credentials in the same user/project scope. Missing or inaccessible tasks can return 400 rather than always 404.

Wait for queued / in_progress, download on completed, and stop automation on failed / unknown. Snapshots may lag upstream; progress does not replace status. Plugins may preserve extra fields; a provider-specific url is not universally present.

Integration guide and runnable example

简体中文

Authorizations

Authorization · string · header · required

模型调用 API Key，不是控制台登录凭据 / Model API key, not console login credentials

Path Parameters

task_id · string · required

同一用户/项目范围内的网关公开 ID / Public gateway ID in the same user/project scope

Response

200

application/json

任务快照，可能尚未更新到最新上游状态 / Task snapshot; may lag upstream state

id · string · required

网关公开任务 ID，后续查询/下载使用此值 / Public gateway task ID; use for retrieval/download

Example:

"task_example"

object · string · required

Example:

"video"

model · string · required

当前密钥可用且支持此接口的模型 ID / Model ID available to the key and supporting this endpoint

Example:

"YOUR_MODEL_ID"

status · enum<string> · required

以状态判断完成；unknown 必须单独处理 / Determine completion from status; handle unknown separately

Available options: queued, in_progress, completed, failed, unknown

progress · integer · required

进度提示，不等同于完成保证 / Progress hint, not proof of completion

created_at · integer · required

Unix 秒 / Unix seconds

completed_at · integer

完成时间，可省略 / Completion timestamp; may be omitted

expires_at · integer

渠道可能提供的过期时间 / Optional expiry from channel

seconds · string

size · string

error · object

Show child attributes

metadata · object