API deteksi citra EMO - Alibaba Cloud Model Studio

Model EMO-detect digunakan untuk memverifikasi bahwa citra potret memenuhi spesifikasi input yang diperlukan untuk model generasi video EMO. Dokumen ini menjelaskan cara memanggil API untuk menggunakan fitur deteksi citra dari model ini.

Penting

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

Ikhtisar Model

Nama Model	Deskripsi Model
emo-detect-v1	emo-detect-v1 adalah model deteksi citra spesifik yang digunakan untuk mendeteksi apakah citra input memenuhi spesifikasi citra potret yang dibutuhkan oleh model EMO.

API HTTP

Deskripsi Fitur

Model ini digunakan untuk mendeteksi apakah gambar input memenuhi spesifikasi potret yang diperlukan untuk generasi video EMO.

Prasyarat

Anda telah mengaktifkan layanan dan memperoleh Kunci API. Untuk informasi lebih lanjut, lihat Memperoleh Kunci API.

Batasan Input

Format Gambar: Gambar harus dalam format JPG, JPEG, PNG, BMP, atau WEBP.
Resolusi Gambar: Sisi terpendek dari gambar harus minimal 400 piksel, dan sisi terpanjang tidak boleh lebih dari 7.000 piksel.
Gambar harus diunggah melalui tautan HTTP. Unggahan file lokal tidak didukung.

Panggil API Pengiriman Pekerjaan

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

Parameter Permintaan

Bidang	Tipe	Metode pengiriman parameter	Diperlukan	Deskripsi	Contoh
Content-Type	String	Header	Ya	Jenis permintaan: application/json.	application/json
Authorization	String	Header	Ya	Kunci API. Contoh: Bearer d1**2a.	Bearer d1**2a
model	String	Body	Ya	Menentukan model yang akan dipanggil. Dalam hal ini, atur nilai menjadi emo-detect-v1. Catatan Jika Anda memanggil model penyebaran di tempat, atur parameter ini ke nama model yang berhasil disebarkan.	emo-detect-v1
input.image_url	String	Body	Ya	URL gambar yang akan dideteksi. Panjang sisi minimum gambar harus lebih besar dari atau sama dengan 400 piksel, dan panjang sisi maksimum harus kurang dari atau sama dengan 7.000 piksel. Format yang didukung: JPG, JPEG, PNG, BMP, dan WEBP. Catatan Unggahan file hanya mendukung tautan HTTP. Jalur file lokal tidak didukung.	http://a/a.jpg
parameters.ratio	String	Body	Ya	Rasio aspek yang diinginkan untuk deteksi dan konfirmasi. Nilai valid: "1:1" dan "3:4". Nilai default adalah "1:1". 1:1 cocok untuk foto profil. 3:4 cocok untuk potret setengah badan.	"ratio": "1:1"

Parameter Respon

Bidang	Tipe	Deskripsi	Contoh
output.check_pass	Bool	Hasil pemeriksaan yang sesuai dengan daftar gambar yang dikirimkan oleh pelanggan.	"check_pass":true/false
output.face_bbox	Array	Kotak pembatas (bbox) area wajah yang dideteksi oleh algoritma. Anda dapat menggunakan nilai ini sebagai parameter permintaan untuk API generasi video EMO. Koordinat area wajah (x1, y1, x2, y2), sesuai dengan koordinat titik kiri atas dan kanan bawah.	[10,20,30,40]
output.ext_bbox	Array	Kotak pembatas area dinamis yang diprediksi oleh algoritma. Anda dapat menggunakan nilai ini sebagai parameter permintaan untuk API generasi video EMO. Rasio aspek area ini konsisten dengan rasio aspek dalam parameter permintaan. Koordinat area dinamis (x1, y1, x2, y2), sesuai dengan koordinat titik kiri atas dan kanan bawah.	[10,20,30,40]
request_id	String	ID unik dari permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh Permintaan

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "emo-detect-v1",
  "input": {
      "image_url":"http://xxx/1.jpg"
  },
  "parameters": {
      "ratio": "1:1"
  }
}'

Contoh Respon (Lulus)

{
    "output":{
        "check_pass": true,
        "face_bbox":[10,20,30,40], # Face bbox
        "ext_bbox": [40,60,80,90] # Dynamic area bbox
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}

Contoh Respon (Gagal)

{
    "output":{
      "check_pass": false, 
      "code": "",
      "message": "",
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}

Alasan Pemeriksaan Gagal

output.message	Alasan	Pesan Pengguna yang Disarankan
Gambar input tidak mengandung orang. Silakan unggah gambar satu orang.	Tidak ada orang yang terdeteksi dalam gambar input.	Tidak ada wajah yang terdeteksi.
Gambar input mengandung beberapa orang. Silakan unggah gambar satu orang.	Beberapa orang terdeteksi dalam gambar input.	Silakan unggah foto satu orang.
Proporsi orang dalam gambar terlalu besar atau terlalu kecil. Silakan unggah gambar lain.	Proporsi orang dalam gambar yang diunggah tidak memenuhi persyaratan.	Proporsi wajah dalam gambar yang diunggah terlalu besar atau terlalu kecil.
Resolusi gambar tidak valid. Pastikan sisi terpanjang gambar kurang dari 7.000 piksel dan sisi terpendek lebih dari 400 piksel.	Ukuran gambar yang diunggah tidak memenuhi persyaratan.	Resolusi tidak boleh lebih rendah dari 400 × 400. Resolusi tidak boleh lebih tinggi dari 7.000 × 7.000.
Kualitas gambar tidak valid. Silakan unggah gambar yang lebih jelas.	Gambar yang diunggah terlalu gelap dan tidak memenuhi persyaratan.	Pastikan wajah dalam gambar jelas.
Pose orang tidak valid. Silakan unggah gambar pandangan depan.	Orang dalam gambar yang diunggah membelakangi kamera, yang tidak memenuhi persyaratan.	Pastikan orang dalam gambar menghadap kamera.
Pose wajah tidak valid. Silakan unggah gambar yang menunjukkan seluruh wajah.	Pose wajah orang dalam gambar yang diunggah tidak memenuhi persyaratan (wajah harus terlihat).	Pastikan wajah dalam gambar lengkap dan tidak tertutup.
Pose wajah tidak valid. Silakan unggah gambar dengan orientasi yang benar.	Pose wajah orang dalam gambar yang diunggah tidak memenuhi persyaratan (orientasi wajah tidak boleh memiliki offset kritis).	Pastikan wajah dalam gambar tidak miring.
Pose orang tidak valid. Silakan unggah gambar yang menunjukkan seluruh tubuh, atau ubah rasio aspek menjadi 1:1.	Pose orang dalam gambar yang diunggah tidak memenuhi persyaratan. Kepala harus sepenuhnya terlihat untuk foto profil, dan tubuh di atas pinggul harus sepenuhnya terlihat untuk potret setengah badan.	Pastikan wajah dalam gambar sepenuhnya terlihat (untuk rasio aspek 1:1). Pastikan bagian tubuh atas orang dalam gambar sepenuhnya terlihat (untuk rasio aspek 3:4).

Kode status

Untuk informasi lebih lanjut tentang kode status umum dari platform layanan model besar, lihat Pesan Kesalahan.

Model ini juga memiliki kode kesalahan spesifik berikut:

Kode balikan HTTP	Kode kesalahan (code)	Pesan kesalahan (message)	Deskripsi
400	InvalidParameter	Permintaan kehilangan parameter yang diperlukan atau dalam format yang salah, silakan periksa parameter yang Anda kirim.	Format parameter permintaan tidak benar.
400	InvalidParameter.Ratio	Parameter permintaan tidak valid, silakan periksa parameter permintaan.	Parameter rasio aspek tidak valid. Nilai yang valid: "1:1" dan "3:4".
400	InvalidURL	URL permintaan tidak valid, silakan periksa apakah URL permintaan tersedia dan format gambar permintaan adalah salah satu dari jenis berikut: JPEG, JPG, PNG, BMP, dan WEBP.	Gagal mengunduh gambar input. Periksa koneksi jaringan atau format input.
400	InvalidFile.NoHuman	Gambar input tidak memiliki tubuh manusia. Silakan unggah gambar lain dengan satu orang.	Tidak ada orang yang terdeteksi di gambar input.
400	InvalidFile.MultiHuman	Gambar input memiliki beberapa tubuh manusia. Silakan unggah gambar lain dengan satu orang.	Beberapa orang terdeteksi di gambar input.
400	InvalidFile.BodyProportion	Proporsi orang yang terdeteksi di gambar terlalu besar atau terlalu kecil, silakan unggah gambar lain.	Proporsi orang di gambar yang diunggah tidak memenuhi persyaratan.
400	InvalidFile.Resolution	Resolusi gambar tidak valid, pastikan panjang maksimum gambar lebih kecil dari 7000, dan panjang minimum gambar lebih besar dari 400.	Ukuran gambar yang diunggah tidak memenuhi persyaratan.
400	InvalidFile.Value	Nilai gambar tidak valid, silakan unggah gambar lain yang lebih jelas.	Gambar yang diunggah terlalu gelap dan tidak memenuhi persyaratan.
400	InvalidFile.FrontBody	Pose orang yang terdeteksi tidak valid, silakan unggah gambar lain dengan tampilan depan.	Orang di gambar yang diunggah menghadap menjauh dari Kamera, yang tidak memenuhi persyaratan.
400	InvalidFile.FullFace	Pose wajah yang terdeteksi tidak valid, silakan unggah gambar lain dengan seluruh wajah.	Pose wajah orang di gambar yang diunggah tidak memenuhi persyaratan (wajah harus terlihat).
400	InvalidFile.FacePose	Pose wajah yang terdeteksi tidak valid, silakan unggah gambar lain dengan orientasi yang diharapkan.	Pose wajah orang di gambar yang diunggah tidak memenuhi persyaratan (orientasi wajah tidak boleh memiliki offset kritis).
400	InvalidFile.FullBody	Pose orang yang terdeteksi tidak valid, silakan unggah gambar lain dengan seluruh tubuh, atau ubah parameter rasio menjadi 1:1.	Pose orang di gambar yang diunggah tidak memenuhi persyaratan (kepala harus sepenuhnya terlihat untuk foto profil, dan tubuh di atas pinggul harus sepenuhnya terlihat untuk potret setengah badan).