Alibaba Cloud Model Studio:AnimateAnyone 画像検出 API リファレンス

検出 API を使用して、入力画像が AnimateAnyone の動画生成に適しているかどうかを確認します。

モデルの概要

モデル	説明
animate-anyone-detect-gen2	入力画像が animate-anyone-gen2 モデルに適しているかどうかを確認します。

例

合格例

全身ショット	半身ショット
頭からつま先まで、遮蔽物なく 1 人の人物が写っています。 大きく回転または傾いておらず、人物がカメラに正面を向いています。	腰から上が、遮蔽物なく 1 人の人物として写っています。 大きく回転または傾いておらず、人物がカメラに正面を向いています。

不合格例

横向き (正面を向いていない)	照明が不十分 (人物が不鮮明)	遮蔽物 (手が隠れている、物を持っている)	背景が複雑	複数の人物

HTTP

前提条件

• サービスを有効化し、API キーを取得します。

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

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2video/aa-detect

リクエストパラメーター

フィールド	タイプ	場所	必須	説明	例
Content-Type	文字列	Header	はい	リクエスト形式です。	application/json
Authorization	文字列	Header	はい	Bearer プレフィックス付きの API キー。	Bearer d1**2a
model	文字列	Body	はい	検出モデル名です。	animate-anyone-detect-gen2
input.image_url	文字列	Body	はい	確認対象の画像 URL (HTTP/HTTPS で一般公開されている必要があります) です。	"image_url": "http://a/a.jpg"

レスポンスパラメーター

フィールド	タイプ	説明	例
output.check_pass	ブール値	画像が検出に合格したかどうかを示します。	true
output.bodystyle	文字列	検出されたボディスタイルです。検出に成功した場合、値は次のいずれかになります。検出に失敗した場合は、空の文字列が返されます。 half：半身ショット full：全身ショット	half
output.reason	文字列	検出失敗理由 (check_pass が false の場合にのみ返されます)。	The input image has no human body...
usage.image_count	整数	確認した画像数です。	1
request_id	文字列	リクエスト識別子です。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

リクエスト例

curl --location --request POST 'https://{WorkspaceId}.cn-beijing.maas.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": "入力画像に人体が含まれていません。1人の人物を含む別の画像をアップロードしてください。",
        "bodystyle": ""
    },
    "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"
}

次のステップ

検出に合格したら、その画像を AnimateAnyone の動画生成 に使用します。

エラーコード

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