Skip to main content
Video Emoji dari Gambar - Emoji

Referensi API Deteksi Gambar Emoji

Model emoji-detect-v1 digunakan untuk mendeteksi kepatuhan gambar. Model ini memeriksa apakah orang dalam gambar input memenuhi persyaratan untuk model Emoji. Jika gambar lolos deteksi, model mengeluarkan koordinat area wajah dan area ekspresi dinamis yang diperluas.

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

Ikhtisar Model

Model

Deskripsi

emoji-detect-v1

Mendeteksi apakah gambar input memenuhi spesifikasi yang diperlukan untuk Pembuatan video Emoji.
Jika deteksi berhasil, model mengeluarkan koordinat area wajah (bbox_face) dan area ekspresi dinamis yang diperluas (ext_bbox_face) untuk digunakan dalam pembuatan video.

Persyaratan Gambar Input

Contoh Gambar yang Sesuai (Deteksi Berhasil)

Persyaratan Gambar

Contoh yang Sesuai

  • Portret tunggal menghadap depan

  • Wajah tidak tertutup (oleh benda seperti tangan, rambut, atau aksesoris)

  • Ekspresi alami, tanpa ekspresi berlebihan

  • Kepala tegak, tanpa kemiringan signifikan

image.png

Contoh Gambar yang Tidak Sesuai (Deteksi Gagal)

Tangan terlihat dekat dengan wajah

Wajah tertutup

Ekspresi berlebihan

Kemiringan kepala berlebihan

image.png

image.png

image.png

image.png

Prasyarat

Anda harus memperoleh Kunci API dan menetapkan Kunci API sebagai Variabel Lingkungan.

HTTP

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

Parameter Permintaan

Header Permintaan
Content-Type string (Diperlukan)Tipe konten dari permintaan. Tetapkan parameter ini ke application/json.Authorization string (Diperlukan)Kredensial otentikasi identitas untuk permintaan. API ini menggunakan Kunci API Model Studio untuk otentikasi identitas. Contoh: Bearer sk-xxxx.
Badan Permintaan
model string (Diperlukan)Nama model. Tetapkan parameter ini ke emoji-detect-v1.input objek (Diperlukan)Informasi input, mencakup gambar yang akan dideteksi.

Properti

image_url string (Diperlukan)URL publik dari gambar yang akan dideteksi. Protokol HTTP dan HTTPS didukung.Batasan gambar:
  • Format gambar: JPEG, JPG, PNG, BMP, atau WEBP.
  • Resolusi gambar: Lebar dan tinggi gambar harus antara 400 dan 7.000 piksel.
  • Ukuran file: Tidak lebih besar dari 10 MB.
Contoh: https://help-static-aliyun-doc.aliyuncs.com/xxx.png.
parameters objek (Diperlukan)Parameter pengeditan gambar.

Properti

ratio string (Diperlukan)Rasio aspek area yang akan dideteksi. Untuk Pembuatan Video Emoji, tetapkan parameter ini ke 1:1.Contoh: 1:1.
  • Deteksi kepatuhan potret
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 '{
    "model": "emoji-detect-v1",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250912/uopnly/emoji-image-detection.png"
    },
    "parameters": {
        "ratio":"1:1"
    }
  }'

Parameter Tanggapan

output objekInformasi keluaran tugas.

Properti

bbox_face array of integerKoordinat area wajah yang terdeteksi. Formatnya adalah [x1, y1, x2, y2] dalam piksel, yang sesuai dengan titik kiri atas dan kanan bawah. Parameter ini hanya dikembalikan jika deteksi berhasil.Gunakan nilai ini untuk parameter input.face_bbox dari API Pembuatan Video Emoji.Contoh: [212,194,460,441].ext_bbox_face array of integerKoordinat area ekspresi dinamis yang diperluas. Formatnya adalah [x1, y1, x2, y2] dalam piksel, yang sesuai dengan titik kiri atas dan kanan bawah. Parameter ini hanya dikembalikan jika deteksi berhasil.Gunakan nilai ini untuk parameter input.ext_bbox dari API Pembuatan Video Emoji.Contoh: [63,30,609,575].code stringKode kesalahan yang dikembalikan jika pemeriksaan gagal. Untuk informasi lebih lanjut, lihat Pesan kesalahan.message stringPesan kesalahan yang dikembalikan jika pemeriksaan gagal. Untuk informasi lebih lanjut, lihat Pesan kesalahan.
request_id stringID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan menyelesaikan masalah.usage objekStatistik keluaran.

Properti

image_count integerJumlah gambar yang dideteksi dalam permintaan. Nilainya adalah 1 dan digunakan untuk penagihan.
Permintaan akan dikenakan biaya jika berhasil, terlepas dari apakah deteksi lolos atau tidak. Permintaan tidak akan dikenakan biaya jika gagal. Untuk informasi lebih lanjut tentang penagihan, lihat Harga Model.
Jika gambar gagal deteksi karena tidak sesuai, panggilan API masih akan dikenakan biaya, karena model menyelesaikan proses deteksi sepenuhnya.
message stringInformasi rinci tentang permintaan yang gagal. Parameter ini tidak dikembalikan jika permintaan berhasil. Untuk informasi lebih lanjut, lihat Pesan kesalahan.request_id stringID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan menyelesaikan masalah.
  • Deteksi Berhasil
  • Deteksi Gagal
  • Permintaan Gagal
Jika permintaan berhasil dan deteksi lolos, permintaan tersebut akan dikenakan biaya. API mengembalikan usage.image_count dalam tanggapan.Simpan nilai bbox_face dan ext_bbox_face yang dikembalikan. Nilai-nilai ini digunakan untuk parameter input.face_bbox dan input.ext_bbox dalam Pembuatan Video Emoji selanjutnya.
{
    "output": {
        "bbox_face": [212,194,460,441],
        "ext_bbox_face": [63,30,609,575]
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "78becbc4-f7f7-41ea-9e38-xxxxxx"
}

Penagihan dan Pembatasan Laju

Kode Kesalahan

Jika pemanggilan model gagal dan pesan kesalahan dikembalikan, lihat Pesan Kesalahan untuk solusi pemecahan masalah.
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
Referensi API Deteksi Gambar Emoji - Alibaba Cloud Model Studio