{
"id": "task_example",
"object": "video",
"model": "YOUR_MODEL_ID",
"status": "queued",
"progress": 0,
"created_at": 1700000000
}API reference
Retrieve video task
Request format, responses, and capability boundaries.
{
"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
模型调用 API Key，不是控制台登录凭据 / Model API key, not console login credentials
Path Parameters
同一用户/项目范围内的网关公开 ID / Public gateway ID in the same user/project scope
Response
任务快照，可能尚未更新到最新上游状态 / Task snapshot; may lag upstream state
网关公开任务 ID，后续查询/下载使用此值 / Public gateway task ID; use for retrieval/download
Example:
"task_example"
Example:
"video"
当前密钥可用且支持此接口的模型 ID / Model ID available to the key and supporting this endpoint
Example:
"YOUR_MODEL_ID"
以状态判断完成；unknown 必须单独处理 / Determine completion from status; handle unknown separately
Available options:
queued, in_progress, completed, failed, unknown 进度提示，不等同于完成保证 / Progress hint, not proof of completion
Unix 秒 / Unix seconds
完成时间，可省略 / Completion timestamp; may be omitted
渠道可能提供的过期时间 / Optional expiry from channel
Show child attributes
Show child attributes