全部产品
Search

搜索本产品

    Alibaba Cloud Model Studio：Referensi API Deteksi Gambar Emoji

    文档中心

    Alibaba Cloud Model Studio：Referensi API Deteksi Gambar Emoji

    更新时间：Oct 25, 2025

    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.

    Penting

    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

    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"
    }
  }'
    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.

    Parameter Tanggapan

    Deteksi Berhasil

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

    Deteksi Gagal

    Jika permintaan berhasil tetapi deteksi wajah gagal, permintaan tersebut akan dikenakan biaya, dan API mengembalikan usage.image_count dalam tanggapan. Untuk menyelesaikan masalah, lihat Pesan Kesalahan.

    {
    "output": {
        "code": "InvalidFile.FacePose",
        "message": "Posisi wajah yang terdeteksi tidak valid, silakan unggah gambar lain dengan orientasi yang diharapkan."
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "ed0d0d8f-e55a-4144-b855-xxxxxx"
}

    Permintaan Gagal

    Jika permintaan API gagal, itu tidak akan dikenakan biaya, dan API tidak mengembalikan usage.image_count. Untuk menyelesaikan kesalahan, lihat Pesan Kesalahan.

    {
    "request_id": "5e1fefbd-fa7a-4e59-82a0-xxxxxx",
    "code": "InvalidParameter",
    "message": "Body yang diperlukan tidak valid, silakan periksa format body permintaan."
}

    output objek

    Informasi keluaran tugas.

    Properti

    bbox_face array of integer

    Koordinat 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 integer

    Koordinat 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 string

    Kode kesalahan yang dikembalikan jika pemeriksaan gagal. Untuk informasi lebih lanjut, lihat Pesan kesalahan.

    message string

    Pesan kesalahan yang dikembalikan jika pemeriksaan gagal. Untuk informasi lebih lanjut, lihat Pesan kesalahan.

    request_id string

    ID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan menyelesaikan masalah.

    usage objek

    Statistik keluaran.

    Properti

    image_count integer

    Jumlah 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.

    Catatan

    Jika gambar gagal deteksi karena tidak sesuai, panggilan API masih akan dikenakan biaya, karena model menyelesaikan proses deteksi sepenuhnya.

    message string

    Informasi rinci tentang permintaan yang gagal. Parameter ini tidak dikembalikan jika permintaan berhasil. Untuk informasi lebih lanjut, lihat Pesan kesalahan.

    request_id string

    ID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan menyelesaikan masalah.

    Penagihan dan Pembatasan Laju

    Kode Kesalahan

    Jika pemanggilan model gagal dan pesan kesalahan dikembalikan, lihat Pesan Kesalahan untuk solusi pemecahan masalah.