表情包视频 Emoji — 创建任务

POST

/services/aigc/image2video/video-synthesis

cURL

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--data '{
    "model": "emoji-v1",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250912/uopnly/emoji-%E5%9B%BE%E5%83%8F%E6%A3%80%E6%B5%8B.png",
        "driven_id": "mengwa_kaixin",
        "face_bbox": [212,194,460,441],
        "ext_bbox": [63,30,609,575]
    }
}'

{
  "output": {
    "task_status": "PENDING",
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
  },
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

根据人物肖像图片和预设表情模板，生成表情包视频。适用于社交媒体表情包、趣味短视频等场景。

前置准备

获取 API Key。
使用 Emoji 图像检测 API 检测人脸，获取 bbox_face（人脸框坐标）和 ext_bbox_face（表情框坐标）。

输入要求

人物图片（image_url）：

格式：JPEG、JPG、PNG、BMP 或 WEBP
分辨率：宽高均在 400～7000 像素之间
文件大小：不超过 10 MB

坐标参数：

face_bbox：人脸区域坐标 [x1, y1, x2, y2]，取自 Emoji 图像检测 API 返回的 output.bbox_face。
ext_bbox：表情区域坐标 [x1, y1, x2, y2]，取自 Emoji 图像检测 API 返回的 output.ext_bbox_face。表情区域略大于人脸区域，包含部分背景和肩部，宽高比约为 1:1。

表情模板

通过 driven_id 指定预设表情模板：

分类	模板 ID
萌娃系列	`mengwa_kaixin`、`mengwa_dengyan`、`mengwa_gandong`、`mengwa_renzhen_1`、`mengwa_jidong`、`mengwa_kun_1`、`mengwa_jiaoxie`
打工系列	`dagong_kaixin`、`dagong_yangwang`、`dagong_kunhuo`、`dagong_zhuakuang`、`dagong_wunai`、`dagong_weixiao`、`dagong_ganji`
经典系列	`jingdian_tiaopi`、`jingdian_deyi_1`、`jingdian_qidai`、`jingdian_landuo_1`、`jingdian_xianqi`、`jingdian_lei`

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

string

默认值"application/json"

必填

请求内容类型。此参数必须设置为 application/json。

string

必填

千问云 API Key。详见获取 API Key。

enum<string>

必填

异步处理配置参数。HTTP请求只支持异步，必须设置为 enable。缺少此请求头将报错："current user api does not support synchronous calls"。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。固定为 emoji-v1。

可选值：emoji-v1

示例:emoji-v1

object

必填

输入的基本信息，如人脸图像、人脸区域、表情包区域等。

显示子属性

string

必填

人脸正面肖像图像的公网 URL。支持 HTTP 或 HTTPS 协议。本地文件可通过上传文件接口获取临时URL。

图像限制：

图像格式：JPEG、JPG、PNG、BMP、WEBP。
图像分辨率：图像的宽度和高度均在[400, 7000]像素之间。
文件大小：不超过10MB。
此图像必须通过 Emoji 图像检测接口进行检测。

示例:https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250912/uopnly/emoji-%E5%9B%BE%E5%83%8F%E6%A3%80%E6%B5%8B.png

integer[]

必填

图片中人脸区域坐标，格式为 [x1, y1, x2, y2]，单位为像素，对应左上和右下两个点的坐标。此参数需填入 Emoji 图像检测接口响应中的 output.bbox_face 字段的值。

示例:

integer[]

必填

动态表情区域坐标，该区域的宽高比约为1:1，格式为 [x1, y1, x2, y2]，单位为像素，对应左上和右下两个点的坐标。此参数需填入 Emoji 图像检测接口响应中的 output.ext_bbox_face 字段的值。

说明：动态表情区域指的是模型进行视频生成时实际关注的正方形图像区域，它通常比人脸区域稍大，以包含部分背景和肩膀，确保动画效果自然。

示例:

enum<string>

必填

预设模板ID，可选值参见附录表情包模板ID列表。

可选值：mengwa_kaixin,mengwa_dengyan,mengwa_gandong,mengwa_renzhen_1,mengwa_jidong,mengwa_kun_1,mengwa_jiaoxie,dagong_kaixin,dagong_yangwang,dagong_kunhuo,dagong_zhuakuang,dagong_wunai,dagong_weixiao,dagong_ganji,jingdian_tiaopi,jingdian_deyi_1,jingdian_qidai,jingdian_landuo_1,jingdian_xianqi,jingdian_lei

示例:mengwa_kaixin

响应

200-application/json

object

任务输出信息。

显示子属性

string

任务ID。查询有效期24小时。

示例:0385dc79-5ff8-4d82-bcb6-xxxxxx

enum<string>

任务状态。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

示例:PENDING

string

请求唯一标识。可用于请求明细溯源和问题排查。

示例:4909100c-7b5a-9f92-bfe5-xxxxxx

​前置准备

​输入要求

​表情模板

鉴权

Header 参数

请求体

响应

前置准备

输入要求

表情模板