EMO — 图像检测

POST

/services/aigc/image2video/face-detect

cURL

curl 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "model": "emo-detect-v1",
  "input": {
    "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251225/onmomb/emo.png"
  },
  "parameters": {
    "ratio": "1:1"
  }
}'

{
  "output": {
    "check_pass": true,
    "face_bbox": [
      302,
      286,
      610,
      593
    ],
    "ext_bbox": [
      71,
      9,
      840,
      778
    ],
    "humanoid": true
  },
  "usage": {
    "image_count": 1
  },
  "request_id": "c56f62df-724e-9c19-96bd-xxxxxx"
}

请先获取 API Key 并配置为环境变量。

EMO 图像检测用于判断输入图像是否符合 EMO 视频生成模型的人物肖像图片规范，通常在生成唱演视频前作为图像筛选步骤使用。检测通过后会返回人脸区域坐标和动态区域坐标，可直接作为 EMO 视频生成 API 的入参。

鉴权

string

header

必填

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

请求体

application/json

enum<string>

必填

模型名称，固定为 emo-detect-v1。

可选值：emo-detect-v1

示例:emo-detect-v1

object

必填

输入图像参数。

显示子属性

string

必填

待检测图像的公网可访问 URL。

图像要求：

格式：JPG、JPEG、PNG、BMP、WEBP
分辨率：宽和高必须在 400 到 7000 像素之间
URL：必须为 HTTP 或 HTTPS 协议的公网可访问地址

<Tip>如需将本地图像上传获取临时 URL，请参考上传文件获取临时URL。</Tip>

示例:https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251225/onmomb/emo.png

object

必填

检测参数。

显示子属性

enum<string>

默认值"1:1"

必填

希望检测确认的画幅比例。

1:1：适用于头像图片（默认值）
3:4：适用于半身像图片

可选值：1:1,3:4

示例:1:1

响应

200-application/json

string

请求唯一标识符，用于链路追踪和问题排查。

示例:c56f62df-724e-9c19-96bd-xxxxxx

object

检测结果。

显示子属性

boolean

图像是否通过检测。true 表示图像符合 EMO 视频生成模型的人物肖像图片规范，false 表示不符合。

示例:true

integer[]

算法检测到的人脸区域坐标 [x1, y1, x2, y2]，对应左上和右下两个点的坐标。可将该值作为 EMO 视频生成 API 的入参。检测通过时返回。

示例:

integer[]

算法预测的动态区域坐标 [x1, y1, x2, y2]，对应左上和右下两个点的坐标。该区域的宽高比与入参画幅一致。可将该值作为 EMO 视频生成 API 的入参。检测通过时返回。

示例:

boolean

检测到的对象是否为人像。true 表示检测到人像，false 表示未检测到人像。

示例:true

string

检测未通过或请求失败时的错误码。检测通过时不返回此字段。

string

检测未通过或请求失败时的错误描述。检测通过时不返回此字段。

object

使用量统计。

显示子属性

integer

本次检测的图像数量，固定为 1。用于计费。

示例:1