API deteksi citra AnimateAnyone - Alibaba Cloud Model Studio

Model deteksi citra AnimateAnyone memverifikasi bahwa citra karakter input memenuhi persyaratan untuk pembuatan 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, Anda harus menggunakan Kunci API untuk wilayah China (Beijing).

Gambaran model

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

Contoh

Contoh citra karakter yang benar

Foto seluruh tubuh

Foto setengah badan

Satu orang terlihat sepenuhnya dari kepala hingga kaki, dan tubuh tidak tertutup.
Orang tersebut menghadap kamera tanpa sudut samping besar atau kemiringan kamera.

AA_正面建议_全身@4x

Satu orang terlihat sepenuhnya dari pinggang ke atas, dan tubuh tidak tertutup.
Orang tersebut menghadap kamera tanpa sudut samping besar atau kemiringan kamera.

AA_正面建议_半身@4x

Contoh gagal citra karakter

Bidikan non-depan

(Tampak samping tubuh dan wajah)

Cahaya redup

(Orang tidak jelas)

Oklusi Orang

(Tangan tertutup pakaian, atau orang sedang memegang objek)

Latar belakang kompleks

Foto dengan banyak orang

AA_错误_侧身侧脸@4x

AA_错误_光线暗淡@4x

AA_错误_手拿物品@4x

AA_错误_复杂背景@4x

Menggunakan HTTP

Deskripsi fitur

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

Prasyarat

Anda telah mengaktifkan Alibaba Cloud Model Studio dan memperoleh Kunci API. Untuk informasi lebih lanjut, lihat Memperoleh Kunci API.

Pengiriman tugas

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

Parameter permintaan

Parameter	Tipe	Metode	Diperlukan	Deskripsi	Contoh
Content-Type	String	Header	Ya	Jenis permintaan. Atur nilainya menjadi application/json.	application/json
Authorization	String	Header	Ya	Kunci API. Contoh: Bearer d1**2a.	Bearer d1**2a
model	String	Body	Ya	Model yang akan dipanggil.	animate-anyone-detect-gen2
input.image_url	String	Body	Ya	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 tanggapan

Parameter	Tipe	Deskripsi	Contoh
output.check_pass	Bool	Hasil pemeriksaan yang sesuai dengan daftar citra yang dikirimkan oleh pelanggan.	"check_pass":true/false
output.bodystyle	String	Gaya tubuh. `half` menunjukkan foto setengah badan, dan `full` menunjukkan foto seluruh tubuh.	"bodystyle": half/full
output.reason	String	Alasan hasil pemeriksaan yang sesuai dengan daftar citra yang dikirimkan oleh pelanggan.
request_id	String	ID permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Alasan deteksi gagal

output.reason	Deskripsi
Citra input tidak mengandung orang atau mengandung beberapa orang. Silakan unggah citra yang mengandung satu orang.	Citra input tidak mengandung orang atau mengandung beberapa orang.
Resolusi citra tidak valid. Sisi terpanjang citra harus kurang dari 4.096 piksel, dan sisi terpendek harus lebih dari 224 piksel.	Ukuran citra yang diunggah tidak memenuhi persyaratan.
Pose orang yang terdeteksi tidak valid. Silakan unggah citra lain yang menampilkan seluruh tubuh dan orientasi yang diharapkan.	Pose orang tidak memenuhi persyaratan. (Bahu dan pergelangan kaki harus terlihat. Orang tidak boleh membelakangi kamera atau duduk. Orientasi orang tidak boleh menyimpang parah.)
Pose wajah yang terdeteksi tidak valid. Silakan unggah citra lain yang menampilkan seluruh wajah dan orientasi yang diharapkan.	Wajah orang tidak memenuhi persyaratan. (Wajah harus terlihat. Orientasi kepala tidak boleh menyimpang parah.)

Permintaan contoh

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

Tanggapan contoh (berhasil)

{
    "output":{
        "check_pass": true,
        "reason": 'success'
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}

Tanggapan contoh (gagal)

{
    "output":{
        "check_pass": false,
        "reason": "no human detect"
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}

Kode status

Untuk informasi tentang kode status umum, lihat Pesan kesalahan.

Model ini juga memiliki kode kesalahan spesifik berikut:

Kode status HTTP*	kode	pesan	Deskripsi
400	InvalidParameter	Parameter required: xxx	Parameter permintaan hilang atau formatnya salah.
400	InvalidURL	URL permintaan tidak valid, silakan periksa apakah URL permintaan tersedia dan format citra permintaan adalah salah satu dari jenis berikut: JPEG, JPG, PNG, BMP, dan WEBP.	Gagal mengunduh citra input. Periksa koneksi jaringan atau format input.
400	InvalidFile.Content	Citra input tidak mengandung tubuh manusia atau mengandung beberapa tubuh manusia. Silakan unggah citra lain dengan satu orang.	Citra input tidak mengandung orang atau mengandung beberapa orang.
400	InvalidFile.Resolution	Resolusi citra tidak valid, pastikan panjang terbesar citra lebih kecil dari 4096, dan panjang terkecil citra lebih besar dari 224.	Ukuran citra yang diunggah tidak memenuhi persyaratan.
400	InvalidFile.BodyPose	Pose orang yang terdeteksi tidak valid, silakan unggah citra lain dengan seluruh tubuh dan orientasi yang diharapkan.	Pose orang tidak memenuhi persyaratan. (Bahu dan pergelangan kaki harus terlihat. Orang tidak boleh membelakangi kamera atau duduk. Orientasi orang tidak boleh menyimpang parah.)
400	InvalidFile.FacePose	Pose wajah yang terdeteksi tidak valid, silakan unggah citra lain dengan seluruh wajah dan orientasi yang diharapkan.	Wajah orang tidak memenuhi persyaratan. (Wajah harus terlihat. Orientasi kepala tidak boleh menyimpang parah.)