# 表情包Emoji 图像

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

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

表情包emoji-detect-v1是一个图像合规性检测模型，用于判断输入图像中的人物形象是否满足“表情包Emoji模型”的要求。检测通过后，该模型输出人脸区域及扩展后的动态表情区域坐标，供后续视频生成使用。

## 请求参数

### Header 参数

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

### Body 参数 application/json 必填

```text
model
string
必需
模型名称。固定为emoji-detect-v1。
input
object
必需
image_url
string
必需
待检测图像的公网 URL。支持 HTTP 或 HTTPS 协议。本地文件可通过上传文件获取临时URL。
图像限制：
图像格式：JPEG、JPG、PNG、BMP、WEBP。
图像分辨率：图像的宽度和高度范围均在[400, 7000]像素之间。
文件大小：不超过10MB。
示例值：
https://help-static-aliyun-doc.aliyuncs.com/xxx.png。
parameters
object
必需
ratio
string
必需
待检测区域的长宽比。对于 Emoji 视频生成，此值固定为 1:1。
示例值：1:1
示例
{
"model"
:
"emoji-detect-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"
}
,
"parameters"
:
{
"ratio"
:
"1:1"
}
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/qwen/api/v1/services/aigc/image2video/face-detect' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "emoji-detect-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"
    },
    "parameters": {
        "ratio":"1:1"
    }
  }'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
object
```

#### 示例

```json
{}
```