API deteksi citra AnimateAnyone - Alibaba Cloud Model Studio

Model deteksi citra AnimateAnyone memverifikasi apakah citra karakter input memenuhi persyaratan model generasi video AnimateAnyone. Dokumen ini menjelaskan cara memanggil API untuk menggunakan fitur deteksi citra yang disediakan oleh model ini.

Penting

Dokumen ini hanya berlaku untuk wilayah China (Beijing). Untuk menggunakan model ini, Anda harus menggunakan API key untuk wilayah China (Beijing).

Ikhtisar model

Model	Deskripsi
animate-anyone-detect-gen2	animate-anyone-detect-gen2 adalah model deteksi citra. Model ini mendeteksi apakah citra input memenuhi spesifikasi citra karakter yang dibutuhkan oleh model animate-anyone-gen2.

Contoh

Contoh yang berhasil

Full-body shot

Half-length shot

Satu orang terlihat seluruh tubuhnya dari kepala hingga kaki, dan tubuh tidak terhalang.
Orang tersebut menghadap Kamera tanpa sudut samping yang besar atau kemiringan Kamera.

AA_正面建议_全身@4x

Satu orang terlihat seluruh tubuhnya dari pinggang ke atas, dan tubuh tidak terhalang.
Orang tersebut menghadap Kamera tanpa sudut samping yang besar atau kemiringan Kamera.

AA_正面建议_半身@4x

Contoh yang gagal

Non-frontal shot

(Sudut samping tubuh dan wajah)

Dim light

(Orang tidak jelas)

Person is blocked

(Tangan tertutup pakaian, atau orang memegang objek)

Complex background

Photo with multiple people

AA_错误_侧身侧脸@4x

AA_错误_光线暗淡@4x

AA_错误_手拿物品@4x

AA_错误_复杂背景@4x

HTTP

Deskripsi fitur

Model ini menentukan apakah citra input memenuhi spesifikasi citra karakter untuk API generasi video AnimateAnyone.

Prasyarat

Anda telah mengaktifkan Alibaba Cloud Model Studio dan membuat API key. Lihat Buat API key.

Titik akhir permintaan

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

Parameter permintaan

Field	Type	Passing parameters	Required	Description	Example
Content-Type	String	Header	Yes	Jenis permintaan: application/json	application/json
Authorization	String	Header	Yes	API key. Contoh: Bearer d1**2a	Bearer d1**2a
model	String	Body	Yes	Model yang dipanggil.	animate-anyone-detect-gen2
input.image_url	String	Body	Yes	URL citra yang akan diperiksa. URL harus berupa alamat yang dapat diakses publik dan mendukung protokol HTTP atau HTTPS.	"image_url": "http://a/a.jpg"

Parameter respons

Field	Type	Description	Example
output.check_pass	Boolean	Hasil Pemindaian untuk daftar citra yang dikirimkan	true
output.bodystyle	String	Gaya tubuh. `half` menunjukkan half-length shot, dan `full` menunjukkan full-body shot.	half
output.reason	String	Alasan hasil pemeriksaan. Parameter ini hanya dikembalikan ketika `check_pass` bernilai `false`.	The input image has no human body...
usage.image_count	Integer	Jumlah citra yang diperiksa.	1
request_id	String	ID unik untuk permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

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"
  }
}'

Contoh respons (permintaan berhasil)

Pemeriksaan citra lolos

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

Pemeriksaan citra gagal

{
    "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"
}

Contoh respons (permintaan gagal)

{
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

Kode error

Untuk informasi tentang kode status umum, lihat Pesan error.