查询视频生成状态

GET  v1/video/generations/{task_id}

查询 Veo 视频生成任务的状态和结果。

端点: GET /v1/video/generations/

任务状态说明：

状态 说明

queued 任务排队中

in_progress 任务进行中

completed 任务完成，可获取视频 URL

failed 任务失败

轮询建议：

最小生成时间：约 11 秒

最大生成时间：约 6 分钟（高峰期）

建议每 10 秒轮询一次

重要提示：

生成的视频在服务器上保留 2 天

请在 2 天内下载视频，否则将被删除

视频会被 SynthID 水印标记

错误处理：

Veo 3.1 有时会因音频安全过滤器或处理问题而阻止视频生成

如果视频被阻止，不会收取费用

请求参数

Authorization

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 Token。

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

Path 参数

字段名	类型	必填	说明
task_id	string	必需	任务id

返回响应

200 成功

Content-Type: application/json

响应参数

字段名	类型	必填	说明
id	string	必需	任务 ID。用于查询该生成任务状态的唯一标识符。
object	string	必需	对象类型。通常为 "video.generation" 或类似的资源类型标识。
model	string	必需	模型名称。执行此任务的模型 ID（例如 veo-3.1-generate-preview）。
status	string	必需	当前状态。任务的处理状态，常见值包括： • RUNNING / PROCESSING：正在生成中 • SUCCEEDED / COMPLETED：生成成功 • FAILED：生成失败
progress	integer	必需	生成进度。以百分比表示的进度（0-100），用于前端展示进度条。
created_at	integer	必需	创建时间戳。任务提交时的 Unix 时间戳。

响应示例

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

示例代码

import http.client
import json

conn = http.client.HTTPSConnection("nxaiapp.com")
payload = json.dumps({})
headers = {
   'Authorization': 'Bearer <token>',
   'Content-Type': 'application/json'
}
conn.request("GET", "/v1/video/generations/", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))