Veo
支持文字、参考图和首尾帧视频生成。
本系列支持的端点
- veo创建
POST https://zexapi.com/v1/videos
https://zexapi.com/v1/videos鉴权 Authorization: Bearer YOUR_API_KEY
使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。
- 素材 URL 应直接返回图片内容,不能传网页地址;需鉴权的链接应自带有效访问参数。
Veo视频生成接口文档
接口地址
POST /v1/videos功能说明
veo_3_1-fast 模型veo_3_1-fast-fl 模型,支持 1~2 张图片作为首尾帧veo_3_1-fast 模型,支持最多 3 张参考图片可用模型列表
-fl)**模式:| 模型名称 | 系列 | 画质档位 | 模式 |
|---|---|---|---|
veo_3_1 | 高质量 | 标准 | 文生 / 参考图 |
veo_3_1-fl | 高质量 | 标准 | 首尾帧 |
veo_3_1-hd | 高质量 | 高清 | 文生 / 参考图 |
veo_3_1-hd-fl | 高质量 | 高清 | 首尾帧 |
veo_3_1-4K | 高质量 | 4K | 文生 / 参考图 |
veo_3_1-4K-fl | 高质量 | 4K | 首尾帧 |
veo_3_1-fast | 快速 | 标准 | 文生 / 参考图 |
veo_3_1-fast-fl | 快速 | 标准 | 首尾帧 |
veo_3_1-fast-hd | 快速 | 高清 | 文生 / 参考图 |
veo_3_1-fast-fl-hd | 快速 | 高清 | 首尾帧 |
veo_3_1-fast-4K | 快速 | 4K | 文生 / 参考图 |
veo_3_1-fast-4K-fl | 快速 | 4K | 首尾帧 |
veo_3_1-lite | 轻量 | 标准 | 文生 / 参考图 |
veo_3_1-lite-fl | 轻量 | 标准 | 首尾帧 |
veo_3_1-lite-hd | 轻量 | 高清 | 文生 / 参考图 |
veo_3_1-lite-hd-fl | 轻量 | 高清 | 首尾帧 |
veo_3_1-lite-4K | 轻量 | 4K | 文生 / 参考图 |
veo_3_1-lite-4K-fl | 轻量 | 4K | 首尾帧 |
关于模型可用性的说明:以上为模型全集,但实际可调用的模型会随平台风控策略与上游资源情况动态调整。在内容安全审核收紧(封控)或上游算力 / 资源紧张时,平台可能临时只开放其中部分模型,其余模型会被下线或返回不可用错误,待限制解除后再恢复开放。因此: 调用前建议先确认当前实际开放的模型范围,不要假设文档列出的所有模型均可直接使用; 如请求中指定的 model当前未开放,接口会返回相应错误,此时可改用其他档位(如将hd/4K降级为标准档,或将veo_3_1/fast切换为lite)重试;长期集成建议做好"模型不可用"的错误处理与备选模型降级逻辑,避免因临时限流影响业务连续性。
请求方式
| 方式 | Content-Type | 图生视频时的图片字段 |
|---|---|---|
| multipart/form-data | multipart/form-data | 使用 input_reference(可重复字段,每张图一个字段),见下文「表单字段说明」 |
| application/json | application/json | 必须使用 images(字符串数组,每项对应一张图);每张图的取值类型与表单 input_reference 一致(图片 URL、Base64 data URI;本地文件见下)。不得在 JSON 中使用 input_reference / input_reference |
input_reference,JSON 为 images 数组)外,单张图的传法与校验规则与表单相同。文生视频用 JSON 时不传 images 或传空数组 [] 即可。请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | multipart/form-data 或 application/json,须与请求体一致 |
表单字段说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称:文生 veo_3_1-fast;首尾帧 veo_3_1-fast-fl;参考图 veo_3_1-fast |
| prompt | string | 是 | 文本提示词 |
| size | string | 否 | 视频尺寸,格式 widthxheight,如 1280x720、1920x1080(详见文末说明) |
| input_reference | 可重复 | 否 | 图生视频时传递,同一字段名可重复多次,每次对应一张图。支持三种取值方式见下表。文生视频不携带本字段即可。 |
input_reference 的三种传法
| 方式 | 说明 |
|---|---|
| 本地文件 | multipart 里以文件部件提交,例如 curl 的 -F "input_reference=@/path/to/image.jpg" |
| 图片 URL | 以普通表单文本提交可公网访问的图片直链,例如 -F "input_reference=https://example.com/a.png"(勿传需登录的短链页面) |
| Base64 | 以文本字段提交完整 data URI,例如 -F "input_reference=data:image/jpeg;base64,/9j/4AAQSkZJRg..." 。多图则多个 -F "input_reference=...",注意 shell 中转义与长度限制。 |
images 每项取值表:每张图一个数组元素,取值规则与上表一致。input_reference 为首帧,第 2 个为尾帧;仅 1 个时表示只指定首帧。input_reference,顺序为参考图 1、2、3。JSON 请求体说明(application/json)
images 每项取值(与表单「单张图」规则一致)
| 方式 | 表单 input_reference | JSON images 数组元素 |
|---|---|---|
| 本地文件 | multipart 中以文件部件上传,例如 -F "input_reference=@/path/to/image.jpg" | 请求体为纯 JSON 时无法附带文件部件;请将文件读成字节后编码为完整 data URI 字符串写入 images,与表单以文本提交 Base64 的方式等价 |
| 图片 URL | 表单文本:-F "input_reference=https://..." | 同左:字符串为可公网访问的图片直链 |
| Base64 | 表单文本:-F "input_reference=data:image/jpeg;base64,..." | 同左:字符串为完整 data:image/...;base64,... |
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 与表单一致:文生 veo_3_1-fast;首尾帧 veo_3_1-fast-fl;参考图 veo_3_1-fast(若网关另有 slug 以实际为准) |
| prompt | string | 是 | 文本提示词 |
| size | string | 否 | 视频尺寸,格式 widthxheight,如 1280x720 |
| images | string[] | 否 | 图生视频必填(有图时):每项为一张图,取值见上表(URL / data URI 等,规则同表单)。禁止使用 input_reference、input_reference 传图。文生视频不传本字段或 []。 |
JSON 示例 · 图生视频 · 首尾帧(URL 列表)
{
"model": "veo_3_1-fl",
"prompt": "广告",
"size": "1280x720",
"images": [
"https://res.papir.cc/user-upload/creati-web-app/2026-04-18/1776519962551vv1AXmBu-ZMWqAckJIbt81167-600x751h.jpg",
"https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png"
]
}curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"model\":\"veo_3_1-fl\",\"prompt\":\"广告\",\"size\":\"1280x720\",\"images\":[\"https://example.com/a.png\",\"https://example.com/b.jpg\"]}"JSON 示例 · 单张 / 多张 Base64(与表单 data URI 文本一致)
{
"model": "veo_3_1-fast-fl",
"prompt": "动画",
"size": "1280x720",
"images": [
"data:image/jpeg;base64,/9j/4AAQSkZJRg..."
]
}请求示例
文生视频(仅表单字段,无图片)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=veo_3_1-fast" \
-F "prompt=一只可爱的小猫在花园里玩耍" \
-F "size=1920x1080"图生视频 · 首尾帧 · 本地文件
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=veo_3_1-fast-fl" \
-F "prompt=让这两张图之间自然过渡" \
-F "size=1280x720" \
-F "input_reference=@/path/to/first_frame.jpg" \
-F "input_reference=@/path/to/last_frame.jpg"图生视频 · 首尾帧 · 图片 URL(同一字段名重复两次)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=veo_3_1-fast-fl" \
-F "prompt=广告" \
-F "size=1280x720" \
-F "input_reference=https://example.com/first.png" \
-F "input_reference=https://example.com/second.jpg"curl.exe 使用 ^ 换行):curl.exe -X POST "https://xxxxx.com/v1/videos" ^
-H "Authorization: Bearer YOUR_API_KEY" ^
-F "model=veo_3_1-fast-fl" ^
-F "prompt=广告" ^
-F "size=1280x720" ^
-F "input_reference=https://example.com/img1.png" ^
-F "input_reference=https://example.com/img2.jpg"图生视频 · 首尾帧 · Base64(文本字段,多图则多个 input_reference)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=veo_3_1-fast-fl" \
-F "prompt=首尾帧动画" \
-F "size=1920x1080" \
-F "input_reference=data:image/jpeg;base64,/9j/4AAQSkZJRg..." \
-F "input_reference=data:image/jpeg;base64,/9j/4AAQSkZJRg..."py示例
import requests
url = "https://xxxx.com/v1/videos"
headers = {
"Authorization": "Bearer Bearer YOUR_KEY"
}
# multipart/form-data
files = [
("model", (None, "veo_3_1-fast-fl")),
("size", (None, "1080x1920")),
("prompt", (None, "广告")),
# 多个 input_reference
("input_reference", (None, "https://res.papir.cc/user-upload/creati-web-app/2026-04-18/1776519962551vv1AXmBu-ZMWqAckJIbt81167-600x751h.jpg")),
("input_reference", (None, "https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png")),
]
response = requests.post(url, headers=headers, files=files)
print(response.status_code)
print(response.text)图生视频 · 参考图 · 本地多文件(最多 3 张)
curl -X POST "https://xxxxx.com/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "model=veo_3_1-fast" \
-F "prompt=根据参考图生成视频" \
-F "size=1280x720" \
-F "input_reference=@/path/to/reference1.jpg" \
-F "input_reference=@/path/to/reference2.jpg" \
-F "input_reference=@/path/to/reference3.jpg"图生视频 · 参考图 · URL 或 Base64
input_reference,每张图为一个 URL 文本或一条 Base64 data URI,规则与首尾帧相同,最多 3 个。响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | 任务ID |
| object | string | 对象类型,固定值:video |
| model | string | 使用的模型名称 |
| status | string | 任务状态:queued(排队中)、processing(处理中)、completed(已完成)、failed(失败) |
| progress | number | 任务进度,0-100 |
| created_at | number | 创建时间戳(秒) |
| completed_at | number | 完成时间戳(秒,仅 completed 状态返回) |
| size | string | 视频尺寸 |
响应示例
任务处理中
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "veo_3_1-fast",
"status": "in_progress",
"progress": 10,
"created_at": 1709876543,
"size": "1920x1080"
}提交成功(排队中)
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "veo_3_1-fast",
"status": "queued",
"progress": 0,
"created_at": 1709876543,
"size": "1920x1080"
}查询任务状态
接口地址
GET /v1/videos/{task_id}请求示例
curl -X GET "https://xxxxx.com/v1/videos/task_xxxxxxxxxxxxx" \
-H "Authorization: Bearer YOUR_API_KEY"响应示例
任务完成
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "veo_3_1-fast",
"status": "completed",
"progress": 100,
"created_at": 1709876543,
"completed_at": 1709876600,
"size": "1920x1080",
"url": "https://example.com/output.mp4",
"video_url": "https://example.com/output.mp4"
}任务失败
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "veo_3_1-fast-fl",
"status": "failed",
"progress": 0,
"created_at": 1709876543,
"error": {
"code": "content_policy_violation",
"message": "内容违反使用政策"
}
}status 为 failed,并额外返回 error 字段:| 参数名 | 类型 | 说明 |
|---|---|---|
| error.code | string | 错误码 |
| error.message | string | 具体错误信息 |
注意事项
application/json 时图必须用 images 数组;不要在 JSON 里写 input_reference。每张图支持的类型(URL、Base64 data URI、本地文件在 JSON 中以 data URI 表示)与表单一致,仅字段形态不同。widthxheight,如 1280x720、1920x1080 等720p1080p1280x720(横屏 720p)、720x1280(竖屏 720p)、1920x1080(横屏 1080p)、1080x1920(竖屏 1080p)input_reference,与多数网关及本客户端约定一致veo_3_1-fast;form 不传 input_reference;JSON 不传 images 或 images: []veo_3_1-fast-fl(部分网关示例为 veo_3_1-fl,以实际为准),1~2 张图;form 用 input_reference,JSON 用 imagesveo_3_1-fast,1~3 张图;form 用 input_reference,JSON 用 imagesinput_reference 与 JSON images 中的字符串同样适用):URL 须为图片直链(返回图片二进制或标准图片 Content-Type),不要传网页 HTML 地址;需鉴权的链接需带合法 query 或请先下载再以文件上传 / data URI 写入 images。Base64 须为完整 data URI 格式,注意体积与网关长度限制。GET /v1/videos/{task_id} 获取进度与结果。接口地址
POST /v1/videos
视频调试参数说明
先选择生成方式,再选择型号。参考图片与首尾帧为独立用法,切换用法后显示对应素材输入。JSON 使用 images 数组;表单使用重复的 input_reference 文件字段。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| size | string | 否 | 横屏 1280x720;竖屏 720x1280。输出画质档位通过完整型号选择。 |
请求示例:参考素材生成(JSON)
{
"model": "veo_3_1-fast",
"prompt": "生成自然连贯的视频",
"images": [
"https://example.com/reference.png"
]
}接口地址
POST /v1/videos
请求示例:文生视频(JSON)
{
"model": "veo_3_1-fast",
"prompt": "生成自然连贯的视频"
}让你的 AI 帮你接入
适用于能接收文字或读取文件的 Codex、Claude Code、WorkBuddy、AI 编辑器等。复制或下载当前接口资料,再交给你使用的 AI 工具完成接入。
真实调用需要令牌(API Key)。它是使用你账户额度的凭证,请勿粘贴到 AI 对话或公开分享。这里仅导出说明,AI 会指导你到配置位置自行填写。
第一次使用?令牌是什么,在哪里填写?
- 先获取令牌。登录你购买或开通接口的服务平台,在“令牌 / API Key / 密钥”页面创建;找不到入口时联系服务提供方。文档中的
YOUR_API_KEY是示例占位符。 - 把资料交给 AI,不要附上真实令牌。AI 会结合你的工具或项目,说明具体配置位置。工具支持专用凭据设置时优先在那里填写;其他情况按指引在本地或服务器配置,避免提交或公开。
- 配置后才能真实调用。只发文档不代表 AI 已获得调用权限或令牌。无法安全配置时,可以先使用示例响应验证,或在“接口文档”的调试台中自行测试。
本地文件和环境变量也可能被有读取权限的 AI 工具访问。如果你要求令牌不进入 AI 对话上下文,需要使用能隔离凭据并代为发送请求的可信工具,不能仅靠这份文档保证。
如果已经泄露,请到签发平台撤销旧令牌并重新生成;只删除聊天消息不够。
资料拿到后,怎么交给 AI?
第一次使用,选“复制给 AI”或“下载 Markdown 资料”其中一种即可,不需要同时操作,也不必安装 Skill。
方式一:复制给 AI(推荐)
- 点击上方“复制给 AI”,复制的是当前接口的接入资料。
- 打开你正在使用的 AI 工具,把资料粘贴到对话输入框中。
- 在资料后面补充你的需求,再发送。如果要修改已有项目,先在工具中打开项目,或提供相关文件。
方式二:下载 Markdown 资料
- 点击“下载 Markdown 资料”,得到一个
.md文件。它是文字资料,不需要运行。 - 在 AI 对话中把这个文件作为附件上传;如果使用能读取项目文件的 AI 工具,也可以把文件放到项目中,并告诉 AI 文件名和位置。
- 发送你的需求,并明确让 AI 先阅读这份资料。如果工具不能读取文件,用文本编辑器打开文件,将全部内容复制到对话中即可。
不知道怎么描述?把资料粘贴或添加文件后,可以接着这样说,并把括号里的内容换成自己的需求:
请先阅读我提供的接口资料,帮我实现【图片生成 / 视频生成等功能】,用于【我的项目或使用场景】。我不熟悉代码,请一步步说明。需要 API 令牌时,告诉我在哪里自行填写,不要让我把真实令牌发到对话里。先使用模拟数据验证,真实调用前告诉我可能产生的费用。
如果 AI 只能聊天,它可以提供步骤和代码;修改项目或执行请求,需要你使用的工具具备相应能力并获得你的授权。这里只提供资料,不会代你调用接口。文档更新后,请重新复制或下载最新资料。
反复接入时,怎样使用 Skill 包?(进阶,可跳过)
Skill 是让 AI 重复使用的一份工作说明,适合经常接入或维护接口的用户。首次使用直接复制资料或下载 Markdown 就够了。
- 点击“下载 Skill 包(进阶)”,解压 ZIP 文件,先阅读包内的
README.md。 - 如果你的工具支持 Skills,按该工具的说明导入完整的
api-integration-assistant目录,保留SKILL.md与references/integration.md的目录关系;不要只上传 ZIP 就默认已经安装成功。 - 在工具中确认技能已识别,再让 AI 使用这份技能,并说明你的接入需求。不同工具的安装方式和启用方式可能不同。
不确定工具是否支持?无需安装,直接把包内的 references/integration.md 交给 AI,使用方法与 Markdown 资料相同。包内不含执行脚本、用户令牌或上传素材,请勿覆盖已有项目指导文件。资料为固定版本 27,未明确的接口能力需要向服务提供方确认。
资料范围:当前页面可见文档。不会附带你在调试台填写的密钥或上传素材。普通开发者也可以直接使用完整接口文档。