跳转到主要内容
图生表情包视频

Emoji — 图像检测

检测图像中的人物形象是否满足表情包 Emoji 视频生成模型的要求

POST
/services/aigc/image2video/face-detect
cURL
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "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"
  }
}'
{
  "output": {
    "bbox_face": [
      212,
      194,
      460,
      441
    ],
    "ext_bbox_face": [
      63,
      30,
      609,
      575
    ]
  },
  "usage": {
    "image_count": 1
  },
  "request_id": "78becbc4-f7f7-41ea-9e38-xxxxxx"
}
emoji-detect-v1 是一个图像合规性检测模型,用于判断输入图像中的人物形象是否满足表情包 Emoji 模型的要求。检测通过后,模型输出人脸区域及扩展后的动态表情区域坐标,供后续 Emoji 视频生成使用。

模型概览

模型名称模型简介
emoji-detect-v1检测输入的图像是否符合 Emoji 视频生成所需要的图像规范。检测通过后,输出人脸区域(bbox_face)和扩展后的动态表情区域(ext_bbox_face)坐标,供视频生成使用。

输入图像要求

合规图像(检测通过)需满足
  • 单人正面肖像
  • 面部无遮挡(如手、头发、饰品等)
  • 表情自然,无夸张表情
  • 头部姿态端正,无大幅度倾斜
不合规图像示例(检测失败)
脸部区域附近露出手部存在面部遮挡存在夸张表情头部倾斜角度过大
手部遮挡面部被遮挡夸张表情头部倾斜

计费与限流

  • 模型免费额度和计费单价请参见模型价格
  • 模型限流请参见限流
当图像因不合规而导致检测不通过时,本次 API 调用仍会正常计费,因为模型已经执行了完整的检测流程。

错误码

如果模型调用失败并返回报错信息,请参见错误信息进行解决。

鉴权

string
header
必填

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

请求体

application/json
enum<string>
必填

模型名称,固定为 emoji-detect-v1

emoji-detect-v1
emoji-detect-v1
object
必填

输入的基本信息,如待检测图像。

object
必填

图像处理参数。

响应

200-application/json
string

请求唯一标识,可用于请求明细溯源和问题排查。

78becbc4-f7f7-41ea-9e38-xxxxxx
object

任务输出信息。

object

输出信息统计。