API deteksi citra LivePortrait - Alibaba Cloud Model Studio

Model LivePortrait-detect memverifikasi apakah citra potret input memenuhi spesifikasi yang diperlukan oleh model LivePortrait. Dokumen ini menjelaskan cara memanggil API untuk fitur deteksi citra tersebut.

Penting

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

Ikhtisar model

Model	Deskripsi
liveportrait-detect	liveportrait-detect adalah model deteksi citra khusus yang digunakan untuk memeriksa apakah citra input memenuhi spesifikasi citra potret yang dibutuhkan oleh model liveportrait.

HTTP

Deskripsi fitur

Model ini mendeteksi apakah citra input memenuhi spesifikasi citra potret yang diperlukan untuk pembuatan video LivePortrait.

Prasyarat

Anda telah mengaktifkan Alibaba Cloud Model Studio dan membuat Kunci API. Untuk informasi selengkapnya, lihat Buat Kunci API.

Batasan input

Format citra yang didukung: JPEG, JPG, PNG, BMP, dan WebP.
Ukuran file citra harus kurang dari 10 MB, rasio aspek maksimal 2, dan panjang sisi terpanjang tidak lebih dari 4.096 piksel.
Citra harus diunggah melalui tautan HTTP. Jalur file lokal tidak didukung.

Pengiriman tugas

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

Parameter permintaan

Field	Type	Parameter passing	Required	Description	Example
Content-Type	String	Header	Yes	Jenis permintaan. Tetapkan nilai ini ke application/json.	application/json
Authorization	String	Header	Yes	Kunci API. Contoh: Bearer d1**2a.	Bearer d1**2a
model	String	Body	Yes	Model yang akan dipanggil. Tetapkan nilai ini ke liveportrait-detect.	liveportrait-detect
input.image_url	String	Body	Yes	URL citra yang akan diperiksa. File citra harus berukuran kurang dari 10 MB, memiliki rasio aspek maksimal 2, dan panjang sisi terpanjang tidak lebih dari 4096 piksel. Format yang didukung: JPEG, JPG, PNG, BMP, dan WebP. Catatan Unggahan file hanya mendukung tautan HTTP atau HTTPS, bukan jalur file lokal.	"image_url": "http://a/a.jpg"

Parameter respons

Field	Type	Description	Example
output.pass	Bool	Hasil pemeriksaan terhadap citra yang dikirimkan.	"pass":true/false
output.message	String	Pesan yang menjelaskan hasil pemeriksaan terhadap citra yang dikirimkan.	"message":No human face detected.
request_id	String	ID unik dari permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Alasan kegagalan

output.message	Description
No human face detected	Tidak ada wajah manusia yang terdeteksi. Hal ini dapat terjadi jika wajah terlalu kecil, dalam posisi profil, atau terhalang.

Contoh permintaan

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "liveportrait-detect",
  "input": {
      "image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250911/ynhjrg/p874909.png"
  }
}'

Contoh respons (lolos)

{
    "output": {
        "pass": true,
        "message": ""
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "a92e2ffd-9263-44ba-92c5-xxxxxx"
}

Contoh respons (gagal)

{
    "output": {
        "pass": false,
        "message": "No human face detected."
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "c56f62df-724e-9c19-96bd-xxxxxx"
}

Contoh respons (error)

{
    "code": "InvalidParameter.UnsupportedFileFormat",
    "message": "Input files format not supported.",
    "request_id": "788b30fe-05f6-999f-a0b1-xxxxxx"
}

Kode kesalahan

Untuk informasi mengenai kode kesalahan umum, lihat Pesan kesalahan.