查询视频任务状态

GET

/v1/videos/{task_id}

最后修改时间：2026-08-12 16:35:37

使用创建任务接口返回的 New API 公开 task_id 查询进度。不要使用中间件内部任务 ID，也不要修改 task_ 前缀。建议每 5～10 秒查询一次，避免高频轮询。

状态说明：queued 表示已排队；in_progress 表示正在生成；completed 表示生成成功；failed 表示生成失败。completed 时 progress 为 100，并返回可直接访问的签名反代 url。failed 时通常返回 error，失败任务按上游规则不扣费。

响应经过精简，不会返回重复的内部 task_id、video_url、download_url 或 metadata 下载地址。

请求参数

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/videos/task_FIeVpQgoAo5Dm4bx50ZjOxxjGhZYZjT8' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json'

返回响应

🟢200

application/json

查询成功。任务尚未完成时不会出现 url；完成后 url 指向签名视频反代地址。

Body

示例

{
    "id": "task_FIeVpQgoAo5Dm4bx50ZjOxxjGhZYZjT8",
    "url": "https://image.example.com/rd-veo/video?u=ZXhhbXBsZQ&sig=example-signature",
    "size": "1280x720",
    "model": "gemini-omni-flash",
    "object": "video",
    "status": "completed",
    "seconds": "10",
    "progress": 100,
    "created_at": 1786548472,
    "completed_at": 1786548524
}

🟠400

🟠401

🟠403

🔴500

修改于 2026-08-12 16:35:37

创建视频生成任务

Gemini生图格式