典名词元典名词元首页
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]

参考生视频非主体调用模式:[1,10]

参考生视频主体调用模式:可选 0-10(0秒时为自动推荐))

image*

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

prompt*string

生成的提示文本(智能多帧生视频模式为“占位文本,输入文字占位即可(后续调整)”)

resolution?string

分辨率,支持:

540p / 720p / 1080p

参考生视频非主体调用模式默认720p

参考生视频主体调用模式默认720p

model*string

模型名称, 支持:

viduq2-pro

_action*string

固定值i2v

seed?integer

随机种子

bgm?boolean

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

参考生视频非主体调用模式中9秒和10秒不生效

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

参考生视频主体调用模式支持:16:9 / 9:16 / 1:1

subjects*

参考主体信息(仅参考生视频主体调用模式支持)

说明:serverId模式:主体接口返回的id,可以使用视频主体、文字主体和图片主体。图片或文字主体最多不超过4个。视频主体最多不超过2个

audio?boolean

是否开启声音(仅参考生视频主体调用模式支持)

false:不需要音视频直出,输出静音视频

true:需要音视频直出,输出带台词以及背景音的视频

注1:该参数为true时,voice_id参数才生效

movementAmplitude?string

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

auto

small

medium

large

headtailImages*

首尾帧图片信息(仅参考生视频模式支持)

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"      }    ],    "headtailImages": {      "headImage": "string",      "tailmage": "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"
}