跳转到主要内容
POST
/
api
/
v1
/
veo
/
generate
生成veo3.1视频
curl --request POST \
  --url https://api.kie.ai/api/v1/veo/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A dog playing in a park",
  "imageUrls": [
    "http://example.com/image1.jpg",
    "http://example.com/image2.jpg"
  ],
  "model": "veo3_fast",
  "watermark": "MyBrand",
  "callBackUrl": "http://your-callback-url.com/complete",
  "aspectRatio": "16:9",
  "seeds": 12345,
  "enableFallback": false,
  "enableTranslation": true,
  "generationType": "REFERENCE_2_VIDEO"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "veo_task_abcdef123456"
  }
}
使用 Veo3.1 API 创建新的视频生成任务。
我们的 Veo 3.1 生成 API 不仅仅是 Google 基线的直接封装。它在官方模型之上增加了广泛的优化和可靠性工具，为您提供更大的灵活性和显著更高的成功率——仅为 Google 官方定价的 25%（完整详情请参见 kie.ai/billing）。
功能详情
模型• Veo 3.1 Quality — 旗舰模型，最高保真度
• Veo 3.1 Fast — 成本效益高的变体，仍能提供出色的视觉效果
任务• 文本 → 视频
• 图片 → 视频（单参考帧或首尾帧）
• 素材 → 视频（基于素材图片生成）
生成模式• TEXT_2_VIDEO — 文生视频：仅使用文本提示词
• FIRST_AND_LAST_FRAMES_2_VIDEO — 首尾帧生视频：使用两张图片生成过渡视频
• REFERENCE_2_VIDEO — 素材生视频：基于素材图片生成（仅支持 Fast 模型和 16:9 比例）
宽高比我们现在支持原生 16:9 和 9:16 输出，允许您生成横向或纵向视频，无需任何额外处理。此外，Auto 模式会根据上传的图片自动匹配宽高比。
语言Google 的原生支持仅限英语；我们的多语言提示词预处理将可靠的生成扩展到大多数主要语言。
音频轨道所有视频默认带有背景音频。在不到 5% 的情况下，当场景被认为是敏感的（例如未成年人）时，Google 会抑制音频。

​
为什么我们的 Veo 3.1 API 与众不同

  1. 真正的竖屏视频 – 原生 Veo 3.1 现在完全支持 9:16 输出，提供真实的竖屏视频，无需重新取景或手动编辑。
  2. 全球语言覆盖 – 提示词清理、token 权重重新平衡将非英语成功率提升到远高于标准 Veo 3.1 行为。
  3. 显著的成本节省 – 我们的费率是 Google 直接 API 定价的 25%。

授权

​
Authorization
string
header
必填

所有 API 都需要通过 Bearer Token 进行认证。

获取 API Key：

  1. 访问 API Key 管理页面 获取您的 API Key

使用方法： 添加到请求头： Authorization: Bearer YOUR_API_KEY

注意：

  • 请妥善保管您的 API Key，不要与他人分享
  • 如果您怀疑 API Key 已泄露，请立即在管理页面重置

请求体

application/json
​
prompt
string
必填

描述所需视频内容的文本提示词。所有生成模式都需要。

  • 应该详细且具体地描述视频内容
  • 可以包含动作、场景、风格等信息
  • 对于图片生成视频，描述希望图片如何动起来
示例:

"A dog playing in a park"

​
imageUrls
string[]

图片链接列表（图片生成视频模式使用）。支持1张或2张图片：

  • 1张图片：生成的视频围绕该图片展开，图片内容会动态呈现
  • 2张图片：第一张图片作为视频的首帧，第二张图片作为视频的尾帧，视频将在两帧之间过渡
  • 必须是有效的图片 URL
  • 图片必须能被 API 服务器访问
示例:
[
  "http://example.com/image1.jpg",
  "http://example.com/image2.jpg"
]
​
model
enum<string>
默认值:veo3_fast

选择使用的模型类型。

  • veo3：veo3.1标准模型，支持文本生成视频和图片生成视频
  • veo3_fast：veo3.1快速生成模型，支持文本生成视频和图片生成视频
可用选项:
veo3,
veo3_fast
示例:

"veo3_fast"

​
generationType
enum<string>

视频生成模式（可选）。指定不同的视频生成方式：

  • 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"

​
watermark
string

水印文本。

  • 可选参数
  • 如果提供，将在生成的视频上添加水印
示例:

"MyBrand"

​
aspectRatio
enum<string>
默认值:16:9

视频的宽高比。用于指定生成视频的尺寸比例。可选值：

  • 16:9：横屏视频格式，支持生成1080P高清视频（仅16:9比例支持生成1080P）
  • 9:16：竖屏视频格式，适合移动端短视频
  • Auto：自动模式，视频会根据上传图片更接近16:9还是9:16自动进行居中裁剪。

默认值为 16:9。

可用选项:
16:9,
9:16,
Auto
示例:

"16:9"

​
seeds
integer

(可选) 随机种子参数，用于控制生成内容的随机性。取值范围为10000-99999。相同的种子会生成相似的视频内容，不同的种子会生成不同的视频内容。不填写时系统自动分配。

必填范围: 10000 <= x <= 99999
示例:

12345

​
callBackUrl
string

用于接收视频生成任务完成更新的URL地址。可选但推荐在生产环境中使用。

  • 系统将在视频生成完成时向此URL发送POST请求，包含任务状态和结果
  • 回调包含生成的视频URL、任务信息等内容
  • 您的回调端点应能接受包含视频结果的JSON载荷的POST请求
  • 详细的回调格式和实现指南，请参见 视频生成回调
  • 或者，您也可以使用获取视频详情接口来轮询任务状态
示例:

"http://your-callback-url.com/complete"

​
enableFallback
boolean
默认值:false
已弃用

是否启用托底机制。当设置为 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/billing

注意：此参数已废弃，请从请求中移除此参数。系统已自动优化内容审核机制，无需手动配置托底功能。

示例:

false

​
enableTranslation
boolean
默认值:true

是否启用提示词翻译为英文。当设置为 true 时，系统会自动将提示词翻译为英文后再进行视频生成，以获得更好的生成效果。默认值为 true。

  • true：启用翻译，提示词会被自动翻译为英文
  • false：不启用翻译，直接使用原始提示词进行生成
示例:

true

响应

请求成功

​
code
enum<integer>

响应状态码

  • 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
​
msg
string

响应消息

示例:

"success"

​
data
object