EMO映像檢測API - Alibaba Cloud Model Studio

EMO-detect模型，用於確認輸入的人物肖像圖片是否符合EMO視頻產生模型的輸入規範。本文檔介紹了該模型提供的映像檢測能力的API調用方法。

重要

本文檔僅適用於“中國大陸（北京）”地區。如需使用模型，需使用“中國大陸（北京）”地區的API Key。

模型概覽

模型名	模型簡介
emo-detect-v1	emo-detect-v1是一個特定的映像檢測模型，用於檢測輸入的圖片是否滿足emo模型所需的人物肖像圖片規範。

HTTP調用介面

功能描述

該模型用於檢測輸入的圖片是否滿足“EMO 視頻產生”所需的人物肖像圖片規範。

前提條件

已開通服務並獲得API-KEY：擷取與配置 API Key。

輸入限制

映像格式：格式為jpg，jpeg，png，bmp，webp。
映像解析度：映像最小邊長≥400像素，最大邊長≤7000像素。
上傳圖片僅支援HTTP連結方式，不支援本地連結方式。

請求介面

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	是	指明需要調用的模型，此處用emo-detect-v1。	emo-detect-v1
input.image_url	String	Body	是	需要檢測的映像URL。映像最小邊長≥400像素，最大邊長≤7000像素。格式支援：jpg、jpeg、png、bmp、webp。說明上傳檔案僅支援HTTP連結方式，不支援本地連結方式。	http://a/a.jpg
parameters.ratio	String	Body	是	希望檢測確認的畫幅，可選 "1:1"或"3:4"。預設值為"1:1"。 1:1適用於頭像圖片。 3:4適用於半身像圖片。	"ratio": "1:1"

出參描述

欄位	類型	描述	樣本值
output.check_pass	Bool	客戶提交的映像列表對應的檢查結果。true表示檢測通過，false表示檢測不通過。	true
output.face_bbox	Array	演算法檢測到的人臉地區bbox，可將該值作為EMO視頻產生API的入參。人臉地區座標（x1，y1，x2，y2），對應左上和右下兩個點的座標。	[10,20,30,40]
output.ext_bbox	Array	演算法預測的動態地區bbox，可將該值作為EMO視頻產生API的入參。該地區的寬高比與入參畫幅一致。動態地區座標（x1，y1，x2，y2），對應左上和右下兩個點的座標。	[10,20,30,40]
usage.image_count	Integer	檢測的映像張數。用於計費。	1
code	String	請求失敗時返回的錯誤碼，詳情請參見狀態代碼說明。	InvalidApiKey
message	String	請求失敗時返回的詳細錯誤資訊，詳情請參見狀態代碼說明。	No API-key provided.
request_id	String	本次請求的系統唯一碼。	7574ee8f-38a3-4b1e-9280-xxxxx

請求樣本

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-raw '{
  "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], #人臉bbox
        "ext_bbox":[71,9,840,778] #動態地區bbox
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-xxxxxx"
}

映像檢測不通過

{
    "output":{
      "check_pass": false, 
      "code": "",
      "message": ""
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-xxxxxx"
}

響應樣本（請求失敗）

{
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

狀態代碼說明

大模型服務平台通用狀態代碼請查閱：錯誤資訊。