EMO イメージ検出 API - Alibaba Cloud Model Studio - Alibaba Cloud ドキュメントセンター

EMO-detect モデルは、入力されたポートレート画像が EMO 動画生成モデルの仕様を満たしているかどうかを検証します。このドキュメントでは、API を呼び出してこのイメージ検出機能を使用する方法について説明します。

重要

このドキュメントは、中国 (北京) リージョンにのみ適用されます。モデルを使用するには、中国 (北京) リージョンの API キーを使用する必要があります。

モデルの概要

モデル	説明
emo-detect-v1	emo-detect-v1 は、入力画像が EMO モデルで要求されるポートレート仕様を満たしているかどうかをチェックする特定のイメージ検出モデルです。

HTTP API

機能説明

このモデルは、入力画像が EMO 動画生成で要求されるポートレート仕様を満たしていることを検証します。

前提条件

サービスを有効化し、API キーを取得済みであること。詳細については、「API キーの取得と設定」をご参照ください。

入力制限

画像フォーマット：JPG、JPEG、PNG、BMP、または WebP。
画像解像度：短辺が 400 ピクセル以上、長辺が 7,000 ピクセル以下である必要があります。
画像は HTTP リンクを使用してアップロードする必要があります。ローカルファイルのアップロードはサポートされていません。

API エンドポイント

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

リクエストパラメーター

フィールド	型	パラメーターの渡し方	必須	説明	例
Content-Type	String	ヘッダー	はい	リクエストのタイプ。application/json に設定します。	application/json
Authorization	String	ヘッダー	はい	API キー。例：Bearer d1**2a。	Bearer d1**2a
model	String	本文	はい	呼び出すモデル。emo-detect-v1 に設定します。	emo-detect-v1
input.image_url	String	本文	はい	検出する画像の URL。短辺は 400 ピクセル以上、長辺は 7,000 ピクセル以下である必要があります。サポートされているフォーマット：JPG、JPEG、PNG、BMP、WebP。説明ファイルのアップロードは HTTP リンクのみをサポートしており、ローカルファイルパスはサポートしていません。	http://a/a.jpg
parameters.ratio	String	本文	はい	チェックするアスペクト比。有効な値は "1:1" と "3:4" です。デフォルト値は "1:1" です。 1:1 はプロフィール写真用です。 3:4 は半身のポートレート用です。	"ratio": "1:1"

レスポンスパラメーター

パラメーター	型	説明	例
output.check_pass	ブール値	送信された画像のチェック結果。`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	リクエストの一意の ID。	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":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-xxxxxx"
}

ステータスコード

大規模モデルサービスプラットフォームの一般的なステータスコードについては、「エラーメッセージ」をご参照ください。