API deteksi citra EMO - Alibaba Cloud Model Studio

Model EMO-detect memvalidasi bahwa citra potret input memenuhi spesifikasi yang dibutuhkan oleh model generasi video EMO. Dokumen ini menjelaskan cara memanggil API untuk menggunakan fitur deteksi citra 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
emo-detect-v1	emo-detect-v1 adalah model deteksi citra spesifik yang memeriksa apakah citra input memenuhi spesifikasi potret yang diperlukan oleh model EMO.

HTTP API

Deskripsi fitur

Model ini memverifikasi bahwa citra input memenuhi spesifikasi potret yang diperlukan untuk generasi video EMO.

Prasyarat

Anda telah mengaktifkan layanan dan memperoleh API key. Untuk informasi selengkapnya, lihat Memperoleh dan mengonfigurasi API key.

Batasan input

Format citra: JPG, JPEG, PNG, BMP, atau WebP.
Resolusi citra: Sisi terpendek minimal 400 piksel, dan sisi terpanjang maksimal 7.000 piksel.
Citra harus diunggah menggunakan tautan HTTP. Unggahan file lokal tidak didukung.

Titik akhir API

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

Parameter permintaan

Field	Type	Passing parameters	Required	Deskripsi	Contoh
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 emo-detect-v1.	emo-detect-v1
input.image_url	String	Body	Yes	URL citra yang akan dideteksi. Sisi terpendek minimal 400 piksel. Sisi terpanjang maksimal 7.000 piksel. Format yang didukung: JPG, JPEG, PNG, BMP, dan WebP. Catatan Unggahan file hanya mendukung tautan HTTP, bukan path file lokal.	http://a/a.jpg
parameters.ratio	String	Body	Yes	Rasio aspek yang akan diperiksa. Nilai yang valid: "1:1" dan "3:4". Default: "1:1". 1:1 digunakan untuk foto profil. 3:4 digunakan untuk potret setengah badan.	"ratio": "1:1"

Parameter respons

Parameter	Type	Deskripsi	Contoh
output.check_pass	Boolean	Hasil pemeriksaan terhadap citra yang dikirimkan. `true` menunjukkan pemeriksaan berhasil. `false` menunjukkan pemeriksaan gagal.	true
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), yang masing-masing merepresentasikan titik kiri atas dan kanan bawah.	[10,20,30,40]
output.ext_bbox	Array	bbox area dinamis yang diprediksi oleh algoritma. Anda dapat menggunakan nilai ini sebagai parameter permintaan untuk API generasi video EMO. Rasio aspek area ini sama dengan rasio aspek dalam permintaan. Koordinat area dinamis (x1, y1, x2, y2), yang masing-masing merepresentasikan titik kiri atas dan kanan bawah.	[10,20,30,40]
usage.image_count	Integer	Jumlah citra yang dideteksi. Parameter ini digunakan untuk penagihan.	1
code	String	Kode kesalahan yang dikembalikan jika permintaan gagal. Untuk informasi selengkapnya, lihat Kode status.	InvalidApiKey
message	String	Pesan kesalahan detail yang dikembalikan jika permintaan gagal. Untuk informasi selengkapnya, lihat Kode status.	No API-key provided.
request_id	String	ID unik dari permintaan.	7574ee8f-38a3-4b1e-9280-xxxxx

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": "emo-detect-v1",
  "input": {
      "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251225/onmomb/emo.png"
  },
  "parameters": {
      "ratio": "1:1"
  }
}'

Contoh respons (permintaan berhasil)

Pemeriksaan Citra Berhasil

{
    "output":{
        "check_pass": true,
        "face_bbox":[302,286,610,593], # Face bbox
        "ext_bbox":[71,9,840,778] # Dynamic area bbox
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-xxxxxx"
}

Pemeriksaan Citra Gagal

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

Contoh respons (permintaan gagal)

{
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-xxxxxx"
}

Kode status

Untuk informasi tentang kode status umum pada platform layanan model tingkat tinggi, lihat Pesan kesalahan.