典名词元典名词元首页
API 文档三方工具教程
AI 模型接口视频Vidu

单图/首尾帧/智能多帧生视频VQ2T

POST/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

_action*string

固定值i2v

model*string

模型名称, 支持:

viduq2-turbo

resolution?string

分辨率,支持:

360p

720p

1080p

seed?integer

随机种子

bgm?boolean

是否开启背景音乐,默认 false

image*object

图片信息(仅图生视频支持)

imageUrl*string

图片链接

headtailImages*object

首尾帧图片信息(仅首尾帧生视频支持)

headImage*object

首帧图片信息

imageUrl*string

图片链接

tailImage*object

尾帧图片信息

imageUrl*string

图片链接

startImage*object

首帧图像,支持 png、jpeg、jpg、webp 格式,图片大小不超过 50 MB,图片比例需要小于 1:4 或者 4:1(仅智能多帧生视频支持)

imageUrl*string

图片链接

imageSettings*array<object>

智能多帧配置,每个任务最少 2 帧,最多 9 帧(仅智能多帧生视频支持)

[]?object
keyImage*object

关键帧图片,作为该段视频的尾帧/下一段的首帧

imageUrl*string

图片链接

prompt?string

延长提示词,用于控制延长的视频内容,最大长度 1500 字符

duration?integer

多帧时长,不同关键帧之间的视频时长,默认 5 秒,可选项为 2~7 秒

prompt*string

生成的提示文本(仅单图、首尾帧模式支持)

duration?integer

视频时长,单位 s,(仅单图、首尾帧模式支持)

图生视频:[1,10]

首尾帧生视频:[1,8]

metaData?string

元数据标识,JSON 格式字符串,透传字段(仅智能多帧生视频支持)

callbackUrl?string

回调地址(仅智能多帧生视频支持)

payload?string

透传参数,不做任何处理,仅数据传输,最多 1048576 个字符(仅智能多帧生视频支持)

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/video/generation" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "_action": "string",    "model": "string",    "resolution": "string",    "seed": 0,    "bgm": true,    "image": {      "imageUrl": "string"    },    "headtailImages": {      "headImage": {        "imageUrl": "string"      },      "tailImage": {        "imageUrl": "string"      }    },    "startImage": {      "imageUrl": "string"    },    "imageSettings": [      {        "keyImage": {          "imageUrl": "string"        },        "prompt": "string",        "duration": 0      }    ],    "prompt": "string",    "duration": 0,    "metaData": "string",    "callbackUrl": "string",    "payload": "string"  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}