# LivePortrait图像检测

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

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

LivePortrait-detect模型，用于确认输入的人物肖像图片是否符合LivePortrait模型的输入规范。本文档介绍了该模型提供的图像检测能力的API调用方法。

## 请求参数

### Header 参数

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

### Body 参数 application/json 必填

```text
model
string
必需
input
object
必需
image_url
string
必需
需要检查的图像 URL。
图像文件<10M，宽高比≤2，最大边长≤4096。
格式支持：jpeg、jpg、png、bmp、webp。
说明
上传文件仅支持HTTP链接方式，不支持本地链接方式。您也可在此获取临时公网URL。
示例
{
"model"
:
"liveportrait-detect"
,
"input"
:
{
"image_url"
:
"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250911/ynhjrg/p874909.png"
}
}
```

## 请求示例代码

### 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": "liveportrait-detect",
  "input": {
      "image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250911/ynhjrg/p874909.png"
  }
}'
```

## 返回响应

### 🟢 200 成功

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

#### 响应结构

```text
object
```

#### 示例

```json
{}
```