表情包Emoji图像检测API详情_大模型服务平台百炼(Model Studio)-阿里云帮助中心

表情包Emoji-detect是辅助表情包Emoji生成的图像检测模型，用于检测图像中的人物形象是否符合视频生成要求。

模型概览

模型名	模型简介

模型名	模型简介
emoji-detect-v1	emoji-detect-v1是一个图像检测模型，专门用于检测输入的图像是否满足emoji-v1模型所需的人物图像规范。

效果示意

人物图像检测通过示意

人物肖像

人物肖像

单人照
正面照
中性表情

人物图像检测不通过示意

头部倾斜角度过大	脸部区域附近露出手部	存在面部遮挡	存在夸张表情

头部倾斜角度过大

脸部区域附近露出手部

存在面部遮挡

存在夸张表情

HTTP调用接口

功能描述

用于检测输入的图像是否符合“Emoji 视频生成API详情”所需要的图像规范，并获得图像中人脸区域和动态区域范围值。

前提条件

已开通服务并获得API-KEY：获取API Key。

作业提交接口调用

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect

入参描述

字段	类型	传参方式	必选	描述	示例值

字段	类型	传参方式	必选	描述	示例值
Content-Type	String	header	是	请求类型：application/json	application/json
Authorization	String	header	是	API-Key，例如：Bearer d1**2a	Bearer d1**2a
model	String	body	是	调用的模型 emoji-detect-v1	emoji-detect-v1
input.image_url	String	body	是	需要检测的图像URL 图像最小边长≥400像素，最大边长≤7000像素。格式支持：jpg、jpeg、png、bmp、webp 说明说明：上传图像仅支持HTTP链接方式，不支持本地链接方式	https://xxx.jpg
parameters.ratio	String	body	是	图像中待检测区域的长宽比，表情包只支持1:1，即头部	1:1

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "emoji-detect-v1",
    "input": {
        "image_url": "https://xxx.jpg"
    },
    "parameters": {
        "ratio":"1:1"
    }
  }'

出参描述

字段	类型	描述	示例值

字段	类型	描述	示例值
output.ext_bbox_face	array	算法检测到的动态区域，需将该值作为表情包生成API的入参。该区域的宽高比与入参画幅一致。动态区域坐标（x1，y1，x2，y2），对应左上和右下两个点的坐标。	[10,20,30,40]
output.bbox_face	array	算法检测到的人脸区域，需将该值作为表情包生成API的入参人脸区域坐标（x1，y1，x2，y2），对应左上和右下两个点的坐标	[10,20,30,40]
request_id	String	本次请求的唯一id	69574ee8f-38a3-4b1e-9280-11c33ab46e51
output.code	String	检测不通过错误码（下附枚举值）	InvalidFile.Content
output.message	String	检测不通过错误消息（下附枚举值）	The input image has no human body. Please upload other image with single person.
usage.image_count	Integer	本次请求检测的图像数量，单位：张	1

响应示例（成功）

{
    "output": {
        "ext_bbox_face": [0, 0, 447, 447],
        "bbox_face": [123, 122, 324, 323]
    },
    "usage": {
        "image_count": 1
    }
    "request_id": "0a855990-2bb0-9118-a6a4-191a7eda0450"
}

响应示例（失败）

{
  "output": {
    "code": "xxxx",
    "message": "xxxx"
  },
  "request_id": "a2702d51-cd62-9d3f-864f-d8138789cc7e"
}

状态码说明

平台通用状态码请查阅：返回状态码说明

同时本模型还有如下特定错误码：

http 返回码*	错误码（code）	错误信息（message）	含义说明
400	InvalidParameter	The request is missing required parameters or in a wrong format, please check the parameters that you send.	入参格式不对
400	InvalidURL	The request URL is invalid, please check the request URL is available and the request image format is one of the following types: JPEG, JPG, PNG, BMP, and WEBP.	输入图像下载失败，请检查网络或者输入格式
400	InvalidFile.NoHuman	The input image has no human body. Please upload other image with single person.	输入图像中没有人
400	InvalidFile.MultiHuman	The input image has multi human bodies. Please upload other image with single person.	输入图像中有多人
400	InvalidFile.BodyProportion	The proportion of the detected person in the picture is too large or too small, please upload other image.	上传图像中人物占比不符合要求
400	InvalidFile.Resolution	The image resolution is invalid, please make sure that the largest length of image is smaller than 7000, and the smallest length of image is larger than 400.	上传图像大小不符合要求
400	InvalidFile.Value	The value of the image is invalid, please upload other clearer image.	上传图像过暗不符合要求
400	InvalidFile.FrontBody	The pose of the detected person is invalid, please upload other image with the front view.	上传图像中人物背身不符合要求
400	InvalidFile.FullFace	The pose of the detected face is invalid, please upload other image with whole face.	上传图像中人物面部姿态不符合要求（要求面部可见）
400	InvalidFile.FacePose	The pose of the detected face is invalid, please upload other image with the expected oriention.	上传图像中人物面部姿态不符合要求（要求面部朝向无严重偏移）
400	InvalidFile.FullBody	The pose of the detected person is invalid, please upload other image with whole body, or change the ratio parameter to 1:1。	上传图像中人物姿态不符合要求（头像照要求头部完整可见，半身照要求髋部以上完整可见）