AnimateAnyone イメージ検出モデルは、入力されたキャラクターイメージが AnimateAnyone ビデオ生成の要件を満たしていることを検証します。このドキュメントでは、API を呼び出してこのモデルが提供するイメージ検出機能を使用する方法について説明します。
このドキュメントは、中国 (北京) リージョンにのみ適用されます。モデルを使用するには、中国 (北京) リージョン用の API キー を使用する必要があります。
モデルの概要
モデル | 説明 |
animate-anyone-detect-gen2 | animate-anyone-detect-gen2 は、入力イメージが animate-anyone-gen2 で要求されるキャラクターイメージの仕様を満たしているかどうかを検出するために使用されるイメージ検出モデルです。 |
例
正しいキャラクターイメージの例
全身ショット | 半身ショット |
|
|
失敗したキャラクターイメージの例]
非正面ショット (体と顔の側面図) | 薄暗い光 (人物が鮮明でない) | 人物のオクルージョン (手が服で覆われている、または人物がオブジェクトを持っている) | 複雑なバックグラウンド | 複数の人物がいる写真 |
|
|
|
|
|
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 | Bool | 顧客が送信したイメージリストに対応するチェック結果。 | "check_pass":true/false |
output.bodystyle | String | ボディスタイル。`half` は半身ショットを示し、`full` は全身ショットを示します。 | "bodystyle": half/full |
output.reason | String | 顧客が送信したイメージリストに対応するチェック結果の理由。 | |
request_id | String | リクエスト ID。 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
検出が失敗した理由
output.reason | 説明 |
入力イメージに人物が含まれていないか、複数の人物が含まれています。1 人の人物が含まれるイメージをアップロードしてください。 | 入力イメージに人物が含まれていないか、複数の人物が含まれています。 |
イメージの解像度が無効です。イメージの最長辺は 4096 ピクセル未満、最短辺は 224 ピクセルより大きい必要があります。 | アップロードされたイメージのサイズが要件を満たしていません。 |
検出された人物のポーズが無効です。全身と期待される向きが写っている別のイメージをアップロードしてください。 | 人物のポーズが要件を満たしていません。(肩と足首が見える必要があります。人物がカメラから背を向けていたり、座っていたりすることはできません。人物の向きに大きなずれがあってはなりません。) |
検出された顔のポーズが無効です。顔全体と期待される向きが写っている別のイメージをアップロードしてください。 | 人物の顔が要件を満たしていません。(顔が見える必要があります。頭の向きに大きなずれがあってはなりません。) |
リクエストの例
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":"http://xxx/1.jpg"
},
"parameters": {
}
}'応答の例 (成功)
{
"output":{
"check_pass": true,
"reason": 'success'
},
"usage":{
"image_count":1
},
"request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}応答の例 (失敗)
{
"output":{
"check_pass": false,
"reason": "no human detect"
},
"usage":{
"image_count":1
},
"request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}状態コード
一般的な状態コードについては、「エラーメッセージ」をご参照ください。
このモデルには、次の特定のエラーコードもあります。
HTTP ステータスコード* | code | message | 説明 |
400 | InvalidParameter | Parameter required: xxx | リクエストパラメーターが欠落しているか、フォーマットが正しくありません。 |
400 | InvalidURL | リクエスト URL が無効です。リクエスト URL が利用可能であり、リクエストイメージのフォーマットが JPEG、JPG、PNG、BMP、WEBP のいずれかであることを確認してください。 | 入力イメージのダウンロードに失敗しました。ネットワーク接続または入力フォーマットを確認してください。 |
400 | InvalidFile.Content | 入力イメージに人体が含まれていないか、複数の人体が含まれています。1 人の人物が含まれる別のイメージをアップロードしてください。 | 入力イメージに人物が含まれていないか、複数の人物が含まれています。 |
400 | InvalidFile.Resolution | イメージの解像度が無効です。イメージの最長辺が 4096 未満、最短辺が 224 より大きいことを確認してください。 | アップロードされたイメージのサイズが要件を満たしていません。 |
400 | InvalidFile.BodyPose | 検出された人物のポーズが無効です。全身と期待される向きが写っている別のイメージをアップロードしてください。 | 人物のポーズが要件を満たしていません。(肩と足首が見える必要があります。人物がカメラから背を向けていたり、座っていたりすることはできません。人物の向きに大きなずれがあってはなりません。) |
400 | InvalidFile.FacePose | 検出された顔のポーズが無効です。顔全体と期待される向きが写っている別のイメージをアップロードしてください。 | 人物の顔が要件を満たしていません。(顔が見える必要があります。頭の向きに大きなずれがあってはなりません。) |