POST
/
api
/
v1
/
veo
/
generate
生成 Veo3 视频
curl --request POST \
  --url https://api.veo3api.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": "9:16",
  "seeds": 123456,
  "enableFallback": false
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "veo_task_abcdef123456"
  }
}

​
使用模式

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

​
托底机制

我们提供了托底机制来提高特定错误情况下的生成成功率。通过 enableFallback 参数启用后，当遇到特定错误条件时，系统将自动尝试使用替代模型生成视频。
托底生成重要说明：
  • 宽高比限制: 托底生成仅适用于 16:9 宽高比
  • 分辨率: 托底视频现在默认生成 1080p 分辨率，但获取 1080P 视频接口可能无法正常工作
  • 积分消耗: 成功的托底生成使用不同的积分消耗。详情请查看 https://veo3api.ai/billing
  • 图片要求: 使用图片转视频模式时，图片必须是 16:9 宽高比，否则将被自动裁剪
  • 积分退还: 如果原始任务积分 > 托底模型积分，差值将退还到您的账户

​
托底触发条件

当生成回调中出现以下错误消息时，将触发托底机制：
  • public error minor upload
  • Your prompt was flagged by Website as violating content policies
  • public error prominent people upload
当出现这些错误且启用托底时，系统将自动尝试使用托底模型进行生成。

Authorizations

​
Authorization
string
header
required

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

获取 API Key：

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

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

Body

application/json

Response

200
application/json

请求成功

The response is of type object.