Veo 3.1 是 Google 推出的新一代视频生成模型，支持文本/图片输入、最高 4K 分辨率输出，并原生支持同步语音与音效生成。AutoRouter 通过统一的 `/v1/video/generations` 异步任务接口对外提供服务。

Veo 3.1 视频生成

Veo 3.1 是 Google 推出的新一代视频生成模型，支持文本/图片输入、最高 4K 分辨率输出，并原生支持同步语音与音效生成。AutoRouter 通过统一的 /v1/video/generations 异步任务接口对外提供服务。

Veo 3.1 是异步任务型接口：提交后立即返回 task_id，需要轮询任务状态，成功后从 data.url 下载视频。

一、支持的模型

模型 ID	版本	特点	适用场景
`veo-3.1-generate-001`	Veo 3.1	最高画质，支持 4K，原生音频	高质量创意内容、商业制作
`veo-3.1-fast-generate-001`	Veo 3.1 Fast	更快速度，均衡画质	快速迭代、批量生成
`veo-3.1-lite-generate-001`	Veo 3.1 Lite	最快速度，最低成本	原型验证、低成本场景

3 个模型统一使用同一个接口路径，仅通过 model 字段区分。所有模型均支持文生视频与图生视频，均可选择是否生成音频。

二、通用接口

2.1 提交任务

POST /v1/video/generations

请求头

Header	必填	说明
`Authorization`	✓	`Bearer sk-你的APIKey`
`Content-Type`	✓	`application/json`

请求体字段

字段	类型	必填	说明
`model`	string	✓	Veo 3.1 模型 ID，见上表
`prompt`	string	✓	视频描述提示词，支持中英文，建议英文获得最佳效果
`size`	string	—	分辨率：`720p` / `1080p` / `4000`（4K，部分模型支持），默认 `1080p`
`duration`	int	—	视频时长（秒），可选 `4` / `6` / `8`，默认 `8`
`generate_audio`	bool	—	是否生成同步音频（语音、音效、背景音），默认 `false`
`images`	string[]	—	图生视频参考图公网 URL 数组；传入后模型以此图为起点生成后续动作。支持首帧图或尾帧图，通过 `lastFrameImage` 字段指定尾帧
`negative_prompt`	string	—	负向提示词，描述不希望出现的内容
`aspect_ratio`	string	—	宽高比，可选 `16:9` / `9:16`，默认 `16:9`
`seed`	int	—	随机种子，用于提升结果可复现性
`lastFrameImage`	string	—	尾帧图公网 URL；当 `images` 传入图片时，指定该图片作为尾帧（模型生成过渡动作）
`input_reference`	string	—	（兼容旧版）图生视频首帧图公网 URL，功能同 `images[0]`

generate_audio: true 会显著提高费用（约 2 倍），请按需开启。详见第六节计费说明。

响应

{
  "id": "task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j",
  "task_id": "task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j",
  "object": "video",
  "model": "veo-3.1-generate-001",
  "status": "queued",
  "progress": 0,
  "created_at": 1778590105
}

2.2 查询任务状态

GET /v1/video/generations/{task_id}

响应采用 AutoRouter 统一的 {code, message, data} 包装格式。

响应（成功 / succeeded）

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j",
    "status": "succeeded",
    "error": null,
    "format": "mp4",
    "metadata": null,
    "url": "https://autorouter.top/v1/videos/task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j/content"
  }
}

响应（失败 / failed）

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j",
    "status": "failed",
    "error": "SafetyFilterActivated: prompt violates content policy",
    "format": null,
    "metadata": null,
    "url": null
  }
}

状态枚举

状态	说明
`queued`	已提交，等待处理
`processing`	生成中
`succeeded`	已完成，`data.url` 为视频下载地址
`failed`	生成失败，`data.error` 为原因

data 字段说明

字段	类型	说明
`task_id`	string	任务 ID
`status`	string	任务状态
`error`	string / null	失败原因，成功时为 null
`format`	string / null	输出格式（如 `mp4`），处理中或失败时为 null
`metadata`	object / null	附加元数据
`url`	string / null	视频下载地址，处理中或失败时为 null

视频下载地址（data.url）为临时签名链接，24 小时有效，获取后请尽快下载或转存。

三、OpenAI 兼容接口（可选）

除 /v1/video/generations 外，也支持 OpenAI 风格的 /v1/videos 接口，两者完全等价。

提交：POST /v1/videos（请求体字段相同）

查询：GET /v1/videos/{task_id}，返回 OpenAI 扁平格式：

{
  "id": "task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j",
  "object": "video",
  "model": "veo-3.1-generate-001",
  "status": "completed",
  "progress": 100,
  "created_at": 1778590105,
  "completed_at": 1778590201
}

OpenAI 兼容接口的查询响应不包含视频 URL。如需获取下载地址，请使用 /v1/video/generations/{task_id} 接口，从 data.url 获取。

四、完整调用示例

# Step 1: 提交任务
curl -X POST https://autorouter.top/v1/video/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "A golden retriever playing fetch on a sunny beach, cinematic wide shot, slow motion",
    "size": "1080p",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

# Step 2: 轮询（建议间隔 10~15 秒）
curl https://autorouter.top/v1/video/generations/task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j \
  -H "Authorization: Bearer sk-你的APIKey"

# Step 3: data.status == "succeeded" 后下载视频
curl -o output.mp4 "https://autorouter.top/v1/videos/task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j/content"

# 开启 generate_audio: true，同步生成语音/音效/背景音
curl -X POST https://autorouter.top/v1/video/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "A jazz musician performing on a rainy street at night, neon lights reflecting on wet pavement",
    "size": "1080p",
    "duration": 8,
    "generate_audio": true
  }'

开启音频后费用约为纯视频的 2 倍，Veo 3.1 的 1080p 8 秒含音频 quota = 1,360,000。

# 通过 images 传入参考图，模型以此图为起点生成视频
curl -X POST https://autorouter.top/v1/video/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-generate-001",
    "prompt": "The cat slowly opens its eyes and stretches, sunlight streaming through the window",
    "images": ["https://example.com/cat.jpg"],
    "size": "1080p",
    "duration": 8
  }'

curl -X POST https://autorouter.top/v1/video/generations \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-fast-generate-001",
    "prompt": "The cat slowly opens its eyes and stretches, birds chirping outside",
    "images": ["https://example.com/cat.jpg"],
    "size": "1080p",
    "duration": 8,
    "generate_audio": true
  }'

五、三个模型对比

对比项	Veo 3.1	Veo 3.1 Fast	Veo 3.1 Lite
模型 ID	`veo-3.1-generate-001`	`veo-3.1-fast-generate-001`	`veo-3.1-lite-generate-001`
画质	最高	均衡	基础
速度（实测 8s 视频）	90130 秒	75105 秒	5080 秒
最高分辨率	4K	1080p	1080p
音频支持	✓	✓	✓
图生视频	✓	✓	✓

六、计费说明

纯视频（generate_audio: false）

模型	720p	1080p	4K
`veo-3.1-generate-001`	$0.20 / 秒	$0.20 / 秒	$0.40 / 秒
`veo-3.1-fast-generate-001`	$0.08 / 秒	$0.10 / 秒	$0.25 / 秒
`veo-3.1-lite-generate-001`	$0.03 / 秒	$0.05 / 秒	—

视频 + 音频（generate_audio: true）

模型	720p	1080p	4K
`veo-3.1-generate-001`	$0.40 / 秒	$0.40 / 秒	$0.60 / 秒
`veo-3.1-fast-generate-001`	$0.10 / 秒	$0.12 / 秒	$0.30 / 秒
`veo-3.1-lite-generate-001`	$0.05 / 秒	$0.08 / 秒	—

quota 换算公式：

quota = modelPrice × QuotaPerUnit × groupRatio × pricingRatio × seconds

QuotaPerUnit = 500,000
groupRatio   = 1.0（生产 default 组）

示例（veo-3.1-generate-001，1080p，8 秒，含音频）：
  modelPrice   = 0.20
  pricingRatio = 2.0（含音频时翻倍）
  quota = 0.20 × 500,000 × 1 × 2.0 × 8 = 1,600,000

示例（veo-3.1-lite-generate-001，1080p，8 秒，纯视频）：
  modelPrice   = 0.03
  pricingRatio ≈ 1.667（1080p 系数）
  quota = 0.03 × 500,000 × 1 × 1.667 × 8 ≈ 200,000

任务失败（failed）时 AutoRouter 会自动退款，无需手动处理。

七、轮询建议

项	建议
轮询间隔	10~15 秒，不低于 5 秒
终态判断	`data.status == "succeeded"` 或 `data.status == "failed"`
总超时时间	建议 5 分钟
典型耗时（实测 8s 视频）	Lite：50~~80 秒；Fast：75~~105 秒；Standard：90~130 秒
视频 URL 有效期	24 小时，获取后立即下载或转存

简易轮询脚本（Bash）

#!/bin/bash
TID="task_DduhCcHShyasO6lCV7o5SK9JQEYUnO1j"
KEY="sk-你的APIKey"
while true; do
  RESP=$(curl -sS "https://autorouter.top/v1/video/generations/$TID" \
    -H "Authorization: Bearer $KEY")
  echo "$RESP"
  STATUS=$(echo "$RESP" | python3 -c \
    "import sys,json;print(json.load(sys.stdin)['data'].get('status',''))")
  case "$STATUS" in
    succeeded|failed) break ;;
  esac
  sleep 15
done

八、错误处理

HTTP 错误

状态码	原因	处理
`400`	参数错误（缺少 `prompt`、非法 `duration` 值等）	检查请求体字段
`401`	API Key 无效或过期	检查 Authorization 头
`403`	API Key 无权访问此模型	检查 token 模型白名单
`402`	余额不足	前往 AutoRouter 控制台充值

任务失败（failed）

常见原因	处理建议
内容安全策略拦截（`data.error` 包含安全审核原因）	调整 prompt，避免敏感内容；添加 `negative_prompt`
图片 URL 无法访问	确保 `images` 中的 URL 公开可访问、未过期
`duration` 值不在支持范围	使用 `4` / `6` / `8` 之一
模型不支持 4K	`veo-3.1-lite-generate-001` 不支持 `4000` 分辨率

九、常见问题

Veo 3.1 和 Veo 3.1 Fast / Lite 该如何选择？

按需求选择：

Veo 3.1：最高画质，支持 4K，适合最终输出和商业制作，费用最高。
Veo 3.1 Fast：速度与画质均衡，适合快速迭代与预览，费用适中。
Veo 3.1 Lite：速度最快、成本最低，适合原型验证和大批量测试。

generate_audio 会生成什么类型的音频？

Veo 3.1 的音频生成为原生同步，包含：

对话/语音（如画面中有人物说话）
环境音效（风声、水声、脚步声等）
背景音乐

无法单独控制每类音频，生成结果由模型根据 prompt 和视频内容自动决定。

duration 只能是 4/6/8 秒吗？

是的，目前支持的有效值为 4、6、8 秒（整数）。传入其他值可能导致报错或被默认覆盖为 8。

图生视频支持几张参考图？

通过 images 数组传入参考图，支持以下方式：

首帧图：仅传入 images，模型以此为起点生成视频
尾帧图：传入 images 的同时设置 lastFrameImage 为尾帧图 URL，模型生成首帧到尾帧的过渡动作

多图参考暂不支持。

4K 分辨率（size: 4000）所有模型都支持吗？

不是，目前仅 veo-3.1-generate-001 支持 4K 输出。veo-3.1-fast-generate-001 和 veo-3.1-lite-generate-001 最高支持 1080p。

同一 seed 能复现相同结果吗？

固定 seed 可以提升可复现性，但由于模型的概率特性，不保证每次结果完全一致。

视频结果 URL 什么时候过期？

临时签名链接一般 24 小时后过期。最佳实践：成功后立即下载并转存到你自己的存储。

Veo 3.1 视频生成

目录