生成veo3.1视频
生成 Veo 3.1 AI 视频（快速&质量）
POST
生成veo3.1视频
使用 Veo3.1 API 创建新的视频生成任务。
| 功能 | 详情 |
|---|---|
| 模型 | • Veo 3.1 Quality — 旗舰模型，最高保真度 • Veo 3.1 Fast — 成本效益高的变体，仍能提供出色的视觉效果 |
| 任务 | • 文本 → 视频 • 图片 → 视频（单参考帧或首尾帧） • 素材 → 视频（基于素材图片生成） |
| 生成模式 | • TEXT_2_VIDEO — 文生视频：仅使用文本提示词 • FIRST_AND_LAST_FRAMES_2_VIDEO — 首尾帧生视频：使用一张或两张图片生成视频（支持过渡） • REFERENCE_2_VIDEO — 素材生视频：基于素材图片生成（仅 Fast 模型，支持 16:9 & 9:16） |
| 宽高比 | 支持原生 16:9 与 9:16 输出。Auto 模式会根据输入素材与内部策略自动决定宽高比（生产环境建议显式设置 aspect_ratio 以便更可控）。 |
| 输出质量 | 16:9 与 9:16 均支持 1080P 与 4K 输出。4K 需要额外 credits（约为生成 Fast 视频 credits 的 2×），并通过单独的 4K 接口请求。 |
| 音频轨道 | 所有视频默认带有背景音频。在少数情况下，上游可能会在场景被判定为敏感（例如未成年人）时抑制音频。 |
为什么我们的 Veo 3.1 API 与众不同
- 真正的竖屏视频 – 原生 Veo 3.1 支持 9:16 输出，提供真实的竖屏视频，无需重新取景 or 手动编辑。
- 全球语言覆盖 – 默认支持多语言提示词（无需额外配置）。
- 显著的成本节省 – 我们的费率是 Google 直接 API 定价的 25%。
授权
所有 API 都需要通过 Bearer Token 进行认证。
获取 API Key：
- 访问 API Key 管理页面 获取您的 API Key
使用方法： 添加到请求头： Authorization: Bearer YOUR_API_KEY
注意：
- 请妥善保管您的 API Key，不要与他人分享
- 如果您怀疑 API Key 已泄露，请立即在管理页面重置
请求体
application/json
描述所需视频内容的文本提示词。所有生成模式都需要。
- 应该详细且具体地描述视频内容
- 可以包含动作、场景、风格等信息
- 对于图片生成视频，描述希望图片如何动起来
示例:
"A dog playing in a park"
图片链接列表（图片生成视频模式使用）。支持1张或2张图片：
- 1张图片：生成的视频围绕该图片展开，图片内容会动态呈现
- 2张图片：第一张图片作为视频的首帧，第二张图片作为视频的尾帧，视频将在两帧之间过渡
- 必须是有效的图片 URL
- 图片必须能被 API 服务器访问
示例:
[
"http://example.com/image1.jpg",
"http://example.com/image2.jpg"
]选择使用的模型类型。
- veo3：veo3.1标准模型，支持文本生成视频和图片生成视频
- veo3_fast：veo3.1快速生成模型，支持文本生成视频和图片生成视频
可用选项:
veo3, veo3_fast 示例:
"veo3_fast"
视频生成模式（可选）。指定不同的视频生成方式：
- TEXT_2_VIDEO：文生视频 - 仅使用文本提示词生成视频
- FIRST_AND_LAST_FRAMES_2_VIDEO：首尾帧生视频 - 灵活的图片到视频生成模式
- 传1张图片：基于该图片生成视频
- 传2张图片：第一张作为首帧，第二张作为尾帧，生成过渡视频
- REFERENCE_2_VIDEO：参考图生视频 - 基于参考图片生成视频，需要在 imageUrls 中提供1-3张图片（至少1张，最多3张）
重要提示：
- REFERENCE_2_VIDEO 模式目前仅支持 veo3_fast 模型和 16:9 宽高比
- 不填写时系统会根据是否提供 imageUrls 自动判断生成模式
可用选项:
TEXT_2_VIDEO, FIRST_AND_LAST_FRAMES_2_VIDEO, REFERENCE_2_VIDEO 示例:
"TEXT_2_VIDEO"
水印文本。
- 可选参数
- 如果提供，将在生成的视频上添加水印
示例:
"MyBrand"
视频的宽高比。用于指定生成视频的尺寸比例。可选值：
- 16:9：横屏视频格式。
- 9:16：竖屏视频格式，适合移动端短视频
- Auto：自动模式，视频会根据上传图片更接近16:9还是9:16自动进行居中裁剪。
默认值为 16:9。
可用选项:
16:9, 9:16, Auto 示例:
"16:9"
(可选) 随机种子参数，用于控制生成内容的随机性。取值范围为10000-99999。相同的种子会生成相似的视频内容，不同的种子会生成不同的视频内容。不填写时系统自动分配。
必填范围:
10000 <= x <= 99999示例:
12345
用于接收视频生成任务完成更新的URL地址。可选但推荐在生产环境中使用。
- 系统将在视频生成完成时向此URL发送POST请求，包含任务状态和结果
- 回调包含生成的视频URL、任务信息等内容
- 您的回调端点应能接受包含视频结果的JSON载荷的POST请求
- 详细的回调格式和实现指南，请参见 视频生成回调
- 为确保回调安全性，请参阅 Webhook 校验指南 了解签名验证实现方法
- 或者，您也可以使用获取视频详情接口来轮询任务状态
示例:
"http://your-callback-url.com/complete"
是否启用托底机制。当设置为 true 时，如果官方 Veo3.1 视频生成服务不可用或出现异常，系统将自动切换到备用模型进行视频生成，以确保任务的连续性和可靠性。默认值为 false。
- 开启托底后，当遇到以下错误时会启用备用模型：
- public error minor upload
- Your prompt was flagged by Website as violating content policies
- public error prominent people upload
- 托底模式要求 16:9 宽高比，默认使用 1080p 分辨率生成视频
- 通过托底机制生成的视频无法通过 Get 1080P Video 端点访问
- 积分消费说明：成功兜底的积分消耗是不同的，具体计费详情请查看 https://kie.ai/pricing
注意：此参数已废弃，请从请求中移除此参数。系统已自动优化内容审核机制，无需手动配置托底功能。
示例:
false
是否启用提示词翻译为英文。当设置为 true 时，系统会自动将提示词翻译为英文后再进行视频生成，以获得更好的生成效果。默认值为 true。
- true：启用翻译，提示词会被自动翻译为英文
- false：不启用翻译，直接使用原始提示词进行生成
示例:
true
响应
请求成功
响应状态码
- 200: 成功 - 请求已成功处理
- 400: 1080P正在处理中。预计1-2分钟后准备就绪。请稍后再次查看。
- 401: 未授权 - 认证凭据缺失或无效
- 402: 积分不足 - 账户没有足够的积分执行操作
- 404: 未找到 - 请求的资源或端点不存在
- 422: 验证错误 - 请求参数验证失败。当未开启托底且生成失败时，错误信息格式为：Your request was rejected by Flow(原始错误信息). You may consider using our other fallback channels, which are likely to succeed. Please refer to the documentation.
- 429: 请求限制 - 已超过该资源的请求限制
- 455: 服务不可用 - 系统正在进行维护
- 500: 服务器错误 - 处理请求时发生意外错误
- 501: 生成失败 - 视频生成任务失败
- 505: 功能禁用 - 请求的功能当前已禁用
可用选项:
200, 400, 401, 402, 404, 422, 429, 455, 500, 501, 505 响应消息
示例:
"success"