典名词元典名词元首页
API 文档
AI 模型接口视频Vidu

图生视频VQ2P

POST
/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

duration?integer

视频时长(智能多帧生视频模式不支持),单位 s,支持: (单图、参考生视频模式)[1,10] (首尾帧)[1,8]

image*

图片信息(单图生视频模式)

prompt*string

生成的提示文本,必填

resolution?string

分辨率,支持: 540p 720p 1080p

model*string

模型名称, 支持: iduq2-pro

_action*string

固定值i2v

seed?integer

随机种子,非必填

bgm?boolean

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

offPeak?boolean

是否使用错峰模式,非必填。错峰模式下任务优先级较低,生成时间可能较长(最长18小时),但价格更优惠

startImage*

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

imageSettings*

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

metaData?string

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

callbackUrl?string

回调地址(智能多帧生视频模式)

payload?string

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

voiceId?string

音色id(单图生视频模式)

characterImages*

参考图片信息(参考生视频非主体调用模式),必填,如果不上传视频,则支持上传1-7张图,如果上传视频则支持1-4张图

videos*

视频信息(参考生视频非主体调用模式),必填,支持上传1~2个视频

aspectRatio?string

比例(参考生视频类调用模式),非必填,默认 16:9 , 支持: 16:9 9:16 3:4 4:3 1:1

subjects*

参考主体信息(参考生视频主体调用模式) serverId模式:主体接口返回的id,可以使用视频主体、文字主体和图片主体。图片或文字主体最多不超过4个。视频主体最多不超过2个

audio?boolean

是否开启声音(参考生视频主体调用模式) false:不需要音视频直出,输出静音视频 true:需要音视频直出,输出带台词以及背景音的视频 注1:该参数为true时,voice_id参数才生效 注2:该参数为true时,不支持错峰模式

movementAmplitude?string

运动幅度(参考生视频主体调用模式),非必填,默认 auto, 支持: auto small medium large

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 '{    "image": {      "imageUrl": "string"    },    "prompt": "string",    "model": "string",    "_action": "string",    "startImage": {      "imageUrl": "string"    },    "imageSettings": [      {        "keyImage": {          "imageUrl": "string"        }      }    ],    "characterImages": [      {        "imageUrl": "string"      }    ],    "videos": [      {        "videoUrl": "string",        "mediaId": "string"      }    ],    "subjects": [      {        "images": [          {            "imageUrl": "string"          }        ],        "serverId": "string",        "id": "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"
}