# Emoji 视频生成

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

[官方api 文档](https://help.aliyun.com/zh/model-studio/emoji-api)

表情包emoji-v1模型可基于人物肖像图片和预设模板ID，生成人脸表情包视频。

## 请求参数

### Header 参数

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

### Body 参数 application/json 必填

```text
model
string
必需
模型名称。固定为emoji-v1。
input
object
必需
image_url
string
必需
人脸正面肖像图像的公网 URL。支持 HTTP 或 HTTPS 协议。本地文件可通过上传文件获取临时URL。
图像限制：
图像格式：JPEG、JPG、PNG、BMP、WEBP。
图像分辨率：图像的宽度和高度均在[400, 7000]像素之间。
文件大小：不超过10MB。
此图像必须通过Emoji 图像检测。
示例值：
https://help-static-aliyun-doc.aliyuncs.com/xxx.png。
driven_id
string
必需
预设模板ID，可选值参见表情包模板ID列表。
示例值：mengwa_kaixin。
face_bbox
array
[integer]
必需
图片中人脸区域坐标，格式为 [x1, y1, x2, y2]，单位为像素，对应左上和右下两个点的坐标。
此参数需填入Emoji 图像检测接口响应中的output.bbox_face 字段的值。
示例值：[212,194,460,441]。
ext_bbox
array
[integer]
必需
动态表情区域坐标，该区域的宽高比约为1:1，格式为 [x1, y1, x2, y2]，单位为像素，对应左上和右下两个点的坐标。
此参数需填入Emoji 图像检测接口响应中的output.ext_bbox_face字段的值。
示例值：[63,30,609,575]。
说明：动态表情区域指的是模型进行视频生成时实际关注的正方形图像区域，它通常比人脸区域稍大，以包含部分背景和肩膀，确保动画效果自然。
示例
{
"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
]
}
}
```

## 请求示例代码

### Shell

```bash
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": "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]
    }
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

```json
{}
```