查询视频生成状态 Copy

GET

v1/video/{task_id}

查询视频生成任务的状态和结果。
任务状态说明：
queued：任务排队中
in_progress：任务进行中
completed：任务完成，可获取视频 URL
failed：任务失败
轮询建议：
最小延迟：11 秒
最大延迟：6 分钟（高峰期）
建议每 10 秒轮询一次

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json必填

示例

{}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'v1/video/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功

application/json

Body

示例

{
    "id": "cHJlZGljdExvbmdSdW5uaW5nL29wZXJhdGlvbnMvMTIzNDU2Nzg5MA",
    "object": "video",
    "model": "veo-3.1-fast-generate-preview",
    "status": "queued",
    "progress": 0,
    "created_at": 1760488792
}

修改于 2026-03-16 14:55:01

Veo 视频生成（OpenAI 兼容格式）

luma