Skip to main content
Video Menyanyi dan Berakting dari Gambar – EMO

Referensi API deteksi citra EMO

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.

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

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.

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) 

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

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.
Penggunaan API
Generasi teks
Pembuatan Gambar
  • FAQ
Video Generation
Model Dunia
Audio
  • Pembuatan audio
Real-time multimodal
Realtime API
Penyematan Teks
Lainnya Model
Toolkit/Framework
TokenPlan
Model production
Manajemen file
Penagihan
Manajemen Model
Lebih Banyak Tentang Model