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

参考生视频VQ2

POST/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

_action*string

固定值i2v

model*string

模型名称, 支持:

viduq2

characterImages*array<object>

参考图片信息(非主体调用模式),最大支持七张图片

[]?object
imageUrl*string

图片链接

prompt*string

生成的提示文本,必填

duration?integer

视频时长,单位 s,支持:[1,10]

resolution?string

分辨率,支持:

360p,540p,720p,1080p

seed?integer

随机种子,非必填

aspectRatio?string

比例,(默认16:9,可选值如下:16:9、9:16、3:4、4:3、1:1

bgm?boolean

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

subjects*array<object>

参考主体信息(主体调用模式)(每个主体最多三张图,最大支持七张图片)。

serverId模式:主体接口返回的id,最大支持7个

[]?object
images*array<object>

参考主体图片信息

[]?object
imageUrl*string

图片url地址

serverId*string

参考主体标识信息,需调用创建主体接口生成

id*string

prompt的标识信息,@xxx 在prompt使用。

传入serverId时,该参数值需设置为主体的elementName。

voiceId?string

参考主体音色,非必填

audio?boolean

是否开启声音(主体调用模式)

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

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

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

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",    "characterImages": [      {        "imageUrl": "string"      }    ],    "prompt": "string",    "duration": 0,    "resolution": "string",    "seed": 0,    "aspectRatio": "string",    "bgm": true,    "subjects": [      {        "images": [          {            "imageUrl": "string"          }        ],        "serverId": "string",        "id": "string",        "voiceId": "string"      }    ],    "audio": true  }'
{
  "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"
}