全部產品
Search
文件中心

Alibaba Cloud Model Studio:AnimateAnyone 映像檢測API參考

更新時間:Dec 27, 2025

AnimateAnyone映像檢測模型,用於確認輸入的人物映像是否符合AnimateAnyone視頻產生模型的要求。本文檔介紹了該模型提供的映像檢測能力的API調用方法。

重要

本文檔僅適用於“中國大陸(北京)”地區。如需使用模型,需使用“中國大陸(北京)”地區的API Key

模型概覽

模型名

模型簡介

animate-anyone-detect-gen2

animate-anyone-detect-gen2是一個映像檢測模型,專門用於檢測輸入的圖片是否滿足animate-anyone-gen2模型所需的人物映像規範。

效果樣本

人物映像檢測通過樣本

人物全身照

人物半身照

  • 單人從頭到腳完整露出、身體無遮擋

  • 面朝鏡頭,無大角度側身或鏡頭俯仰

AA_正面建議_全身@4x

  • 單人腰部以上完整露出、身體無遮擋

  • 面朝鏡頭,無大角度側身或鏡頭俯仰

AA_正面建議_半身@4x

人物映像檢測不通過樣本

非正面照

(側身側臉)

光線暗淡

(人物不清晰)

人物遮擋

(服飾遮手、手持物品等)

複雜背景

多人照片

AA_錯誤_側身側臉@4x

AA_錯誤_光線暗淡@4x

AA_錯誤_手拿物品@4x

AA_錯誤_複雜背景@4x

image

HTTP調用介面

功能描述

該模型用於檢測輸入的圖片是否滿足“AnimateAnyone 視頻產生API”所需的人物圖片規範。

前提條件

請求介面

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

入參描述

欄位

類型

傳參方式

必選

描述

樣本值

Content-Type

String

Header

請求類型:application/json

application/json

Authorization

String

Header

API-Key,例如:Bearer d1**2a

Bearer d1**2a

model

String

Body

指明需要調用的模型

animate-anyone-detect-gen2

input.image_url

String

Body

需要檢查的映像 URL

URL 需為公網可訪問的地址,並支援 HTTP 或 HTTPS 協議。

"image_url": "http://a/a.jpg"

出參描述

欄位

類型

描述

樣本值

output.check_pass

Bool

提交的映像列表對應的檢查結果

true

output.bodystyle

String

半身或全身:half 表示半身圖,full 代表全身圖

half

output.reason

String

提交的映像列表對應的檢查結果原因,僅當"check_pass": false返回此參數

The input image has no human body...

usage.image_count

Integer

檢測的圖片數量

1

request_id

String

本次請求的系統唯一碼

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": "The input image has no human body. Please upload other image with single person.",
        "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"
}

狀態代碼說明

大模型服務平台通用狀態代碼請查閱:錯誤資訊