LivePortrait 视频生成

方法: POST路径: /qwen/api/v1/services/aigc/image2video/video-synthesis/

官方api 文档

LivePortrait模型，可基于通过LivePortrait-detect模型检测的人物肖像图片和人声音频文件，快速、轻量化地生成人像动态视频。本文档介绍了该模型提供的视频生成能力的API调用方法。

请求参数

Header 参数

X-DashScope-Async
string
必需
示例:
enable
Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json 必填

model
string
必需
input
object
必需
image_url
string
必需
用户上传的图片 URL，该图应先通过LivePortrait图像检测API。
图像文件<10M，宽高比≤2，最大边长≤4096。
格式支持：jpeg、jpg、png、bmp、webp。
说明
上传文件仅支持HTTP链接方式，不支持本地链接方式。您也可在此获取临时公网URL。
audio_url
string
必需
用户上传的音频文件 URL。
音频文件＜15M，1s＜时长＜3min。
格式支持：wav、mp3。
说明
上传文件仅支持HTTP链接方式，不支持本地链接方式。您也可在此获取临时公网URL。
parameters
object
必需
template_id
string
可选
可按模板控制人物头部的运动姿态和幅度，当前支持3种模板：normal、calm、active。默认为normal。
eye_move_freq
number
可选
每秒眨眼次数，可设值为0-1，值越大眨眼频率越高。默认值为0.5。
video_fps
integer
可选
输出视频帧率，可设值为15-30。默认值为24。
mouth_move_strength
integer
可选
嘴部动作的幅度大小，可设值为0-1.5，值越大嘴型越大。若设为0则嘴部无动作。默认值为1。
paste_back
boolean
可选
生成的人脸是否贴回原图，可设值为true或false。若设为false则仅输出生成的人脸，忽略人物身体。默认值为true。
head_move_strength
number
可选
头部动作幅度，可设值为0-1，值越大头部动作幅度越大。默认值为0.7。
示例
{
"model"
:
"liveportrait"
,
"input"
:
{
"image_url"
:
"http://xxx/1.jpg"
,
"audio_url"
:
"http://xxx/1.wav"
}
,
"parameters"
:
{
"template_id"
:
"normal"
,
"eye_move_freq"
:
0.5
,
"video_fps"
:
30
,
"mouth_move_strength"
:
1
,
"paste_back"
:
true
,
"head_move_strength"
:
0.7
}
}

请求示例代码

Shell

curl --location --request POST '/qwen/api/v1/services/aigc/image2video/video-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "liveportrait",
    "input": {
        "image_url": "http://xxx/1.jpg",
        "audio_url": "http://xxx/1.wav"
    },
      "parameters": {
         "template_id": "normal",
         "eye_move_freq": 0.5,
         "video_fps":30,
         "mouth_move_strength":1,
         "paste_back": true,
         "head_move_strength":0.7
    }
  }'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

object

示例

{}