Veo 3.1

veo3.1-fast、veo3.1-quality、veo3.1-lite：文生/图生视频，固定 8 秒，异步，用 GET /v1/tasks/{task_id} 查询

Veo 3.1 系列当前暂未开放调用。本页字段说明仅供接入预览，实际可用状态以模型列表为准。

POST/v1/videos/generations

GET/v1/tasks/{task_id}

Veo 3.1 通过 /v1 统一异步视频接口调用。提交、轮询、任务对象与错误见接口说明。

项	值
模型	`veo3.1-fast`（快速预览与迭代）、`veo3.1-quality`（高质量成片）、`veo3.1-lite`（低成本批量生成）
模式	异步（提交 → 轮询 `GET /v1/tasks/{task_id}`）
计费	按模型与分辨率档位，时长固定 `8` 秒，先预扣后结算，价格以定价页为准
媒体保留	`video_url` 最长保留至任务完成后 72 小时

三个模型的时长均固定 8 秒，分辨率均为 720p、1080p、4k，默认 8 秒、720p。

快速开始

curl https://api.vibelab.me/v1/videos/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1-fast",
    "prompt": "海豚在碧蓝海洋中跳跃",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

响应示例（HTTP 202）：

{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "veo3.1-fast",
  "status": "pending",
  "created_at": 1772942400,
  "duration": 8,
  "resolution": "720p"
}

用 task_id 调用 GET /v1/tasks/{task_id} 查询结果，见响应。

模式选择

模式	怎么传参
文生视频	只传 `prompt` 与控制字段
图生视频（自动判断）	`image_urls` 传 1–3 张图，不传 `generation_type` 时按图片数量自动判断
首尾帧	`generation_type: "frame"`，`image_urls` 第 1 张为首帧、第 2 张为尾帧
参考图	`generation_type: "reference"`；`veo3.1-quality` 不支持

请求参数

参数	类型	必填	默认	说明
`model`	string	是	-	`veo3.1-fast`、`veo3.1-quality` 或 `veo3.1-lite`
`prompt`	string	是	-	视频内容描述
`duration`	integer	否	`8`	仅支持 `8` 秒
`resolution`	string	否	`720p`	`720p`、`1080p`、`4k`
`aspect_ratio`	string	否	-	`16:9` 或 `9:16`
`generation_type`	string	否	按图片数量自动判断	`frame` 表示首尾帧生成；`reference` 表示参考图生成；`veo3.1-quality` 不支持 `reference`，`veo3.1-lite` 不支持该字段
`image_urls`	string[]	否	-	图生视频参考图，最多 3 张；支持公网图片 URL，单图最大 10MB；`veo3.1-lite` 不支持该字段
`enable_gif`	boolean	否	`false`	是否输出 GIF；不能与 `1080p` 或 `4k` 同时使用
`callback_url`	string	否	-	任务到达终态后的 HTTPS 回调地址

请求示例

首尾帧：

{
  "model": "veo3.1-fast",
  "prompt": "镜头从清晨缓慢过渡到日落",
  "generation_type": "frame",
  "image_urls": ["https://example.com/first.png", "https://example.com/last.png"],
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

响应

用 GET /v1/tasks/{task_id} 查询，状态依次为 pending → running → succeeded / failed（终态）。成功后 video_url 为视频下载地址：

{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "veo3.1-fast",
  "status": "succeeded",
  "progress": 100,
  "created_at": 1772942400,
  "completed_at": 1772942468,
  "duration": 8,
  "resolution": "720p",
  "video_url": "https://media.example.com/video.mp4",
  "expires_at": 1773028868
}

字段	类型	说明
`video_url`	string	视频下载地址，仅 `succeeded` 返回，尽快转存
`expires_at`	integer	`video_url` 失效时间，Unix 秒
`credits_charged`	number	本次实际扣费（积分）
`error`	object	仅 `failed` 返回：`{"code": "timeout" \| "upstream_error", "message": "..."}`

完整任务对象字段见接口说明。

计费

无论请求传什么 duration，预扣均按固定 8 秒；档位按 resolution（未传按 720p）。
终态按实际结果结算，多退少补；失败全额退回预扣。

错误

通用错误见接口说明。

HTTP	code	触发场景	处理
404	`model_not_found`	`resolution` 没有对应售价档位	使用 `720p`、`1080p`、`4k`

本模型的 generation_type、image_urls、enable_gif 等字段由上游校验，不合规的请求可能在 202 之后表现为异步 failed。

注意事项

veo3.1-lite → 不支持 generation_type 与 image_urls。
veo3.1-quality → 不支持 generation_type: reference。
enable_gif: true → 不能与 1080p、4k 同时使用。

Veo 3.1

本页内容