查询视频状态和详情

正式环境

https://poloai.top

GET

/v1/videos/{id}

最后修改时间：2026-04-28 09:57:05

路径参数

参数	类型	必填	说明
`task_id`	string	✅	创建任务时返回的 `id`

响应参数

字段	类型	说明
`id`	string	任务 ID
`model`	string	使用的模型名
`status`	string	任务状态，见状态说明
`progress`	integer	进度 0-100
`video_url`	string	视频下载 URL（仅 `completed` 时返回）
`seconds`	string	视频时长（秒）
`size`	string	画幅比例
`created_at`	integer	创建时间（Unix 时间戳）
`completed_at`	integer	完成时间（Unix 时间戳，仅 `completed` 时返回）
`error.message`	string	错误信息（仅 `failed` 时返回）
`error.code`	string	错误码（仅 `failed` 时返回）

请求参数

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例响应示例（生成中）失败示例

{
    "id": "task_c2501e2846d2bf1d06428da9",
    "model": "veo3.1_fast",
    "status": "completed",
    "progress": 100,
    "video_url": "https://storage.example.com/video_abc123.mp4",
    "seconds": "8",
    "size": "16:9",
    "created_at": 1761622232,
    "completed_at": 1761622385
}

修改于 2026-04-28 09:57:05

创建视频 /v1/videos（新）

下载视频