AnimateAnyone 画像検出 API - Alibaba Cloud Model Studio - Alibaba Cloud ドキュメントセンター

AnimateAnyone 画像検出モデルは、入力されたキャラクター画像が AnimateAnyone 動画生成モデルの要件を満たしているかどうかを検証します。このドキュメントでは、API を呼び出してこのモデルが提供する画像検出機能を使用する方法について説明します。

重要

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

モデル概要

モデル	説明
animate-anyone-detect-gen2	animate-anyone-detect-gen2 は画像検出モデルです。入力画像が animate-anyone-gen2 モデルで要求されるキャラクター画像の仕様を満たしているかどうかを検出します。

例

合格例

全身ショット

半身ショット

頭からつま先まで一人の人物が全身写っており、体が遮られていないこと。
人物がカメラに正対しており、極端な横向きやカメラの傾きがないこと。

AA_正面建议_全身@4x

腰から上の一人の人物が写っており、体が遮られていないこと。
人物がカメラに正対しており、極端な横向きやカメラの傾きがないこと。

AA_正面建议_半身@4x

不合格例

非正面ショット

(体と顔が横向き)

暗い光

(人物が不鮮明)

ユーザーはブロックされています

(手が服で隠れている、または物を手に持っている)

複雑な背景

複数人が写っている写真

AA_错误_侧身侧脸@4x

AA_错误_光线暗淡@4x

AA_错误_手拿物品@4x

AA_错误_复杂背景@4x

HTTP

機能説明

このモデルは、入力画像が AnimateAnyone 動画生成 API のキャラクター画像の仕様を満たしているかどうかを判断します。

前提条件

Alibaba Cloud Model Studio を有効化し、API キーを作成済みであること。詳細については、「API キーの作成」をご参照ください。

リクエストエンドポイント

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

リクエストパラメーター

フィールド	型	パラメーターの引き渡し	必須	説明	例
Content-Type	String	ヘッダー	はい	リクエストのタイプ：application/json	application/json
Authorization	String	ヘッダー	はい	API キー。例：Bearer d1**2a	Bearer d1**2a
model	String	本文	はい	呼び出すモデル。	animate-anyone-detect-gen2
input.image_url	String	本文	はい	チェックする画像の URL。 URL は、HTTP または HTTPS プロトコルをサポートする、一般公開されたアドレスである必要があります。	"image_url": "http://a/a.jpg"

レスポンスパラメーター

フィールド	型	説明	例
output.check_pass	ブール値	送信された画像のスキャン結果	true
output.bodystyle	String	ボディスタイル。`half` は半身ショット、`full` は全身ショットを示します。	half
output.reason	String	チェック結果の理由。このパラメーターは `check_pass` が `false` の場合にのみ返されます。	入力画像に人体が含まれていません...
usage.image_count	整数	チェックされた画像の数。	1
request_id	String	リクエストの一意の ID。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

リクエストの例

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/aa-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "animate-anyone-detect-gen2",
  "input": {
      "image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251224/pkswoc/p883941.png"
  }
}'

レスポンスの例 (リクエスト成功)

画像チェック合格

{
    "output": {
        "bodystyle": "full",
        "check_pass": true
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "76df937d-6eb6-40aa-9ccf-xxxxxx"
}

画像チェック不合格

{
    "output":{
        "check_pass": false,
        "reason": "入力画像に人体が含まれていません。一人だけが写っている別の画像をアップロードしてください。",
        "bodystyle": ""
    },
    "usage":{
        "image_count": 1
    },
    "request_id": "c56f62df-724e-9c19-96bd-xxxxxx"
}

レスポンスの例 (リクエスト失敗)

{
    "code": "InvalidApiKey",
    "message": "API キーが提供されていません。",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

エラーコード

一般的なステータスコードについては、「エラーメッセージ」をご参照ください。