POST
/
api
/
v1
/
veo
/
generate
生成veo3视频
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"
  ],
  "model": "veo3",
  "watermark": "MyBrand",
  "callBackUrl": "http://your-callback-url.com/complete",
  "aspectRatio": "16:9",
  "seeds": 12345,
  "enableFallback": false,
  "enableTranslation": true
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "veo_task_abcdef123456"
  }
}
使用 Veo3 AI 模型创建新的视频生成任务。

​
使用模式

  1. 文本转视频
    • 提供文本提示 prompt
  2. 图片转视频
    • 提供文本提示 prompt 和图片 URL 列表 imageUrls

​
托底功能

通过设置 enableFallback 参数，可以启用智能托底功能。当主要模型遇到特定错误时，系统会自动切换到备用模型继续生成，提高任务成功率。
托底功能特点：
  • 启用条件: 设置 enableFallback: true，宽高比为 16:9，且遇到特定错误
  • 适用错误: public error minor upload、内容政策违规、public error prominent people upload
  • 分辨率: 托底生成的视频默认使用 1080p 分辨率，但无法通过获取1080P视频接口访问
  • 图片要求: 必须为 16:9 比例，否则会进行自动截取
  • 积分计算: 成功兜底的积分消耗是不同的，具体计费详情请查看 https://kie.ai/billing
重要说明
  • 托底功能仅在特定错误场景下生效
  • 未开启托底时，遇到可托底错误会返回 422 状态码
  • 托底生成的视频默认使用 1080p 分辨率，但无法通过获取1080P视频接口访问

Authorizations

​
Authorization
string
header
required

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

获取 API Key：

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

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

注意：

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

Body

application/json

Response

请求成功

The response is of type object.