查询视频生成状态（官方格式）

主站接口

https://api.huandutech.com/v1

GET

/video/generations/{task_id}

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

端点: GET /v1/video/generations/{task_id}

任务状态说明：

状态	说明
queued	任务排队中
in_progress	任务进行中
completed	任务完成，可获取视频 URL
failed	任务失败

轮询建议：

最小生成时间：约 11 秒

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

建议每 10 秒轮询一次

重要提示：

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

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

视频会被 SynthID 水印标记

错误处理：

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

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Header 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.huandutech.com/v1/video/generations/cHJlZGljdExvbmdSdW5uaW5nL29wZXJhdGlvbnMvMTIzNDU2Nzg5MA' \
--header 'Authorization: Bearer <token>'

返回响应

🟢200OK

application/json

查询成功

Body

示例

任务排队中任务进行中任务完成任务失败

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

🟠401Unauthorized

🟠404Not Found

查询视频生成状态

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