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	Bool	顧客が送信した画像リストに対応するチェック結果。	"check_pass":true/false
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]
request_id	String	リクエストの一意の ID。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

リクエスト例

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

レスポンス例 (成功)

{
    "output":{
        "check_pass": true,
        "face_bbox":[10,20,30,40], // 顔 bbox
        "ext_bbox": [40,60,80,90] // 動的領域 bbox
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}

レスポンス例 (失敗)

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

チェック失敗の理由

output.message	理由	推奨されるユーザープロンプト
入力画像に人物が含まれていません。1 人の画像をアップロードしてください。	入力画像に人物が検出されませんでした。	顔が検出されませんでした。
入力画像に複数の人が含まれています。1 人の画像をアップロードしてください。	入力画像に複数の人が検出されました。	1 人の写真をアップロードしてください。
画像内の人物の比率が大きすぎるか小さすぎます。別の画像をアップロードしてください。	アップロードされた画像内の人物の比率が要件を満たしていません。	アップロードされた画像内の顔の比率が大きすぎるか小さすぎます。
画像解像度が無効です。画像の最長辺が 7,000 ピクセル未満、最短辺が 400 ピクセルより大きいことを確認してください。	アップロードされた画像のサイズが要件を満たしていません。	解像度は 400 × 400 以上である必要があります。解像度は 7,000 × 7,000 以下である必要があります。
画質が無効です。より鮮明な画像をアップロードしてください。	アップロードされた画像が暗すぎて要件を満たしていません。	画像内の顔が鮮明であることを確認してください。
人物のポーズが無効です。正面図の画像をアップロードしてください。	アップロードされた画像内の人物がカメラに背を向けており、要件を満たしていません。	画像内の人物がカメラの方を向いていることを確認してください。
顔のポーズが無効です。顔全体が写っている画像をアップロードしてください。	アップロードされた画像内の人物の顔のポーズが要件を満たしていません (顔がはっきり見える必要があります)。	画像内の顔が完全で、隠されていないことを確認してください。
顔のポーズが無効です。正しい向きの画像をアップロードしてください。	アップロードされた画像内の人物の顔のポーズが要件を満たしていません (顔の向きに重大なオフセットがあってはなりません)。	画像内の顔が傾いていないことを確認してください。
人物のポーズが無効です。全身が写っている画像をアップロードするか、縦横比を 1:1 に変更してください。	アップロードされた画像内の人物のポーズが要件を満たしていません。プロフィール写真の場合は頭が完全に見えている必要があり、半身のポートレートの場合は腰より上が完全に見えている必要があります。	画像内の顔が完全に見えていることを確認してください (縦横比 1:1 の場合)。画像内の人物の上半身が完全に見えていることを確認してください (縦横比 3:4 の場合)。

状態コード

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

このモデルには、次の特定のエラーコードもあります。

HTTP リターンコード	エラーコード (code)	エラーメッセージ (message)	説明
400	InvalidParameter	リクエストに必要なパラメーターがないか、形式が正しくありません。送信したパラメーターを確認してください。	リクエストパラメーターの形式が正しくありません。
400	InvalidParameter.Ratio	リクエストパラメーターが無効です。リクエストパラメーターを確認してください。	縦横比パラメーターが無効です。有効な値は「1:1」と「3:4」です。
400	InvalidURL	リクエスト URL が無効です。リクエスト URL が使用可能であり、リクエスト画像フォーマットが次のいずれかのタイプであることを確認してください： JPEG、JPG、PNG、BMP、および WEBP。	入力画像のダウンロードに失敗しました。ネットワーク接続または入力形式を確認してください。
400	InvalidFile.NoHuman	入力画像に人体がありません。1 人を含む別の画像をアップロードしてください。	入力画像に人物が検出されませんでした。
400	InvalidFile.MultiHuman	入力画像に複数の人体が含まれています。1 人を含む別の画像をアップロードしてください。	入力画像に複数の人が検出されました。
400	InvalidFile.BodyProportion	画像内で検出された人物の比率が大きすぎるか小さすぎます。別の画像をアップロードしてください。	アップロードされた画像内の人物の比率が要件を満たしていません。
400	InvalidFile.Resolution	画像解像度が無効です。画像の最大長が 7000 未満、最小長が 400 より大きいことを確認してください。	アップロードされた画像のサイズが要件を満たしていません。
400	InvalidFile.Value	画像の値が無効です。より鮮明な画像をアップロードしてください。	アップロードされた画像が暗すぎて要件を満たしていません。
400	InvalidFile.FrontBody	検出された人物のポーズが無効です。正面図の別の画像をアップロードしてください。	アップロードされた画像内の人物がカメラに背を向けており、要件を満たしていません。
400	InvalidFile.FullFace	検出された顔のポーズが無効です。顔全体が写っている別の画像をアップロードしてください。	アップロードされた画像内の人物の顔のポーズが要件を満たしていません (顔がはっきり見える必要があります)。
400	InvalidFile.FacePose	検出された顔のポーズが無効です。正しい向きの別の画像をアップロードしてください。	アップロードされた画像内の人物の顔のポーズが要件を満たしていません (顔の向きに重大なオフセットがあってはなりません)。
400	InvalidFile.FullBody	検出された人物のポーズが無効です。全身が写っている別の画像をアップロードするか、ratio パラメーターを 1:1 に変更してください。	アップロードされた画像内の人物のポーズが要件を満たしていません (プロフィール写真の場合は頭が完全に見えている必要があり、半身のポートレートの場合は腰より上が完全に見えている必要があります)。