Veo 视频生成

Google Veo 视频生成（异步）。文生视频 / 图生视频共用同一端点。文生视频使用 application/json 提交；带参考图（多图、首尾帧）用 application/json 的 images 数组，或 multipart/form-data 的 input_reference[]。文生视频不接受 multipart/form-data，会返回 invalid request body。

接入地址

线路	Base URL
国内加速（推荐）	`https://cdn.wusag.com`
海外直连	`https://api.xinliu.one`

请求

方法：POST {Base URL}/v1/videos

Header：

Authorization: Bearer 你的令牌

Content-Type: application/json（文生视频必须；带参考图也推荐）。带参考图需用文件部件上传时改用 multipart/form-data

可用模型

8 秒系列（标准）

model	用途	默认尺寸
`veo_3_1-fast`	文生 / 多图参考	720P
`veo_3_1-fast-fl`	首尾帧（1~2 张）	720P
`veo_3_1-fast-hd`	文生 / 多图参考	1080P
`veo_3_1-fast-fl-hd`	首尾帧 1080P	1080P
`veo_3_1`	标准文生 / 多图参考	720P
`veo_3_1-fl`	标准首尾帧	720P
`veo_3_1-lite`	轻量文生	720P

4K 系列

model	用途
`veo_3_1-4K`	4K 文生 / 多图参考
`veo_3_1-4K-fl`	4K 首尾帧
`veo_3_1-fast-4K`	4K Fast 文生 / 多图参考
`veo_3_1-fast-4K-fl`	4K Fast 首尾帧
`veo_3_1-lite-4K`	4K Lite

视频延长：见「Veo 视频延长（Extend）」接口（model 固定 veo_3_1-fast-extend）。

表单字段

字段	类型	必填	说明
`model`	string	是	见上方表格
`prompt`	string	是	文本提示词
`size`	string	否	`widthxheight`，如 `1280x720`、`1920x1080`、`3840x2160`。漏填用 model 默认
`input_reference[]`	file / 文本	否	图生视频时传，同字段名可重复多次，每次对应一张图。三种取值方式见下表

`input_reference[]` 三种传法

方式	说明
本地文件	multipart 文件部件，curl 写法 `-F "input_reference[]=@/path/image.jpg"`
图片 URL	普通文本字段，传可公网访问的直链：`-F "input_reference[]=https://example.com/a.png"`
Base64	文本字段传完整 data URI：`-F "input_reference[]=data:image/jpeg;base64,/9j/4AAQ..."`

模式约定（顺序由 `input_reference[]` 数量决定）

模式	input_reference 数	顺序
文生视频	0	—
首尾帧（仅 `-fl` / `-fast-fl-hd` / `-4K-fl` 等模型）	1~2	第 1 张为首帧，第 2 张为尾帧；只传 1 张表示仅指定首帧
多图参考（非 -fl 模型）	1~3	顺序为参考图 1、2、3

文生视频示例（application/json）

首尾帧示例（图片 URL）

多图参考示例（本地文件，最多 3 张）

4K 文生示例（application/json）

JSON body 写法（application/json）

Veo 视频生成同时支持 application/json 提交，图字段必须用 images 数组（字符串数组），每个元素是一张图，取值方式与 multipart input_reference[] 完全一致：

取值	写法
图片 URL	数组元素是可公网访问的图片直链字符串
Base64	数组元素是完整 `data:image/...;base64,...` 形式
本地文件	JSON 不支持文件部件，需要先转 Base64 data URI 再放入数组

重要：JSON body 里禁止使用 input_reference / input_reference[] 字段（仅 multipart 接受该字段名）。文生视频不传 images 或传 [] 即可。

JSON 示例 · 文生视频

JSON 示例 · 首尾帧（2 张 URL）

JSON 示例 · 多图参考（最多 3 张）

提交后立即返回（HTTP 200）

{
  "id": "task_ZSBy6PsujytMPsm3uve1eToqlawAkjlU",
  "task_id": "task_ZSBy6PsujytMPsm3uve1eToqlawAkjlU",
  "object": "video",
  "model": "veo_3_1-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1778142916,
  "seconds": "0",
  "size": "video_ab5cc8a6-fc79-4266-b17d-ec55f33462d2"
}

注意 size 字段：提交瞬间 size 是 video_<uuid> 形式，等同于后续延长用的 remix_id。视频延长场景必须在提交瞬间立即抓取并保存这个值——completed 状态会出现独立的 remix_id 字段，但部分模型（如 veo_3_1-lite）提交时 size 直接返回真实尺寸（如 1280x720），不返 video_xxx —— 这种 model 不支持视频延长。

任务完成（轮询 GET /v1/videos/{task_id}）

{
  "id": "task_ZSBy6PsujytMPsm3uve1eToqlawAkjlU",
  "size": "video_ab5cc8a6-fc79-4266-b17d-ec55f33462d2",
  "remix_id": "video_ab5cc8a6-fc79-4266-b17d-ec55f33462d2",
  "model": "veo_3_1-fast",
  "object": "video",
  "status": "completed",
  "seconds": "0",
  "video_url": "https://.../video/<uuid>?Expires=...&Signature=...",
  "created_at": 1778142916,
  "completed_at": 1778143042
}

字段说明：

video_url（或 url / result_url）：视频结果签名链接，约 24 小时（Expires 头），过期后失效。

remix_id：用于「Veo 视频延长」接口；veo_3_1-lite 不返回该字段，lite 不支持延长。

seconds 字段始终返回 "0"，不可信，实际时长由 model 决定。

status 取值：queued / in_progress / processing / completed / failed。

任务级失败 - 内容安全审核拒绝

Google Veo 对每个任务都会做内容审核。提交时 200 拿到 task_id，但审核不通过的任务会进 status: failed，错误体如下：

{
  "id": "task_xxx",
  "status": "failed",
  "status_update_time": 1778211452,
  "error": {
    "message": "提交中含有违反平台政策的内容，请你立即停止或调整你的提交内容"
  }
}

常见触发场景：

涉及暴力 / 色情 / 仇恨 / 未成年人不当内容

真实人物（明星 / 政治人物 / 普通人肖像）的图生视频

政治敏感、特定地区敏感主题

版权 IP 角色（迪士尼 / 漫威 / 卡通 IP 等）

参考图本身被识别为违规（即便 prompt 没问题）

处理方式：调整 prompt 措辞 / 更换参考图 / 避开敏感主题后重新提交。本类失败按任务失败计，不消耗额度。

错误码

HTTP	错误体	触发场景
400	`{"code":"missing_prompt","message":"prompt field is required"}`	漏填 prompt
401	`{"error":{"message":"未提供令牌 ...","type":"new_api_error"}}`	漏 / 错 Authorization
503	`{"error":{"message":"分组 default 下模型 X 无可用渠道（distributor） ...","type":"new_api_error"}}`	model 不存在或漏填

Veo 视频生成