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

Referensi API pembuatan video EMO

Model EMO menghasilkan video animasi wajah menggunakan citra potret dan audio suara.

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

Tampilan performa

Contoh inputContoh output
Portret:上春山Audio suara:Kekuatan gaya aksi: Parameter style_level diatur ke 'active'.
Untuk contoh lainnya, lihat Tampilan performa.
Pastikan semua citra dan file audio yang diunggah berasal dari sumber yang mematuhi hukum dan Anda memiliki izin yang diperlukan untuk penggunaannya.

Prasyarat

HTTP

Langkah 1: Buat tugas dan dapatkan ID tugas 

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
  • Setelah tugas dibuat, sistem segera mengembalikan task_id. Anda dapat menggunakan ID ini pada Langkah 2 untuk menanyakan hasil tugas. task_id berlaku selama 24 jam setelah dibuat.

Parameter permintaan

Header
X-DashScope-Async string (Wajib)Parameter konfigurasi pemrosesan asinkron. Permintaan HTTP hanya mendukung pemrosesan asinkron. Anda harus mengatur parameter ini ke enable.
Jika header permintaan ini tidak ada, pesan kesalahan "current user api does not support synchronous calls" akan dikembalikan.
Authorizationstring(Wajib)Header ini digunakan untuk otentikasi identitas. API melakukan autentikasi permintaan menggunakan Kunci API Model Studio. Contoh: Bearer sk-xxxx.Content-Type string (Wajib)Tipe konten permintaan. Atur parameter ini ke application/json.
Badan Permintaan
model string (Wajib)Nama model. Contoh: emo-v1.input object (Wajib)Menentukan informasi input dasar.

Properti

image_url string (Wajib)URL citra yang diunggah. Model memotong citra asli berdasarkan parameter ext_bbox yang dikembalikan oleh API deteksi citra EMO. Rasio aspek area yang dipotong secara langsung menentukan rasio aspek dan resolusi video output.
  • Jika rasio aspek ext_bbox adalah 1:1, video potret profil 512 × 512 dihasilkan. Jika rasio aspeknya 3:4, video potret setengah badan 512 × 704 dihasilkan.
  • Panjang sisi minimum citra harus setidaknya 400 piksel. Panjang sisi maksimum tidak boleh melebihi 7.000 piksel.
  • Format yang didukung: JPG, JPEG, PNG, BMP, dan WebP.
  • Contoh: https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250911/yhdvfg/emo.png.
  • Anda dapat mengunggah file menggunakan tautan HTTP atau HTTPS. Jalur file lokal tidak didukung.
audio_url string (Wajib)URL file audio yang diunggah. File audio ini digunakan sebagai input untuk inferensi model EMO.face_bbox array(Wajib)Koordinat piksel kotak pembatas (bbox) untuk wilayah wajah dalam citra. Anda dapat memperoleh nilai ini dari bidang face_bbox dalam respons API deteksi citra EMO. Format koordinat adalah [x1, y1, x2, y2], yang merepresentasikan koordinat titik kiri atas dan kanan bawah. Contoh: [302,286,610,593].
Sudut kiri atas citra adalah origin (0,0). Sumbu-x memanjang ke kanan, dan sumbu-y memanjang ke bawah.
ext_bbox array(Wajib)Koordinat piksel kotak pembatas (bbox) untuk wilayah dinamis. Anda dapat memperoleh nilai ini dari bidang ext_bbox dalam respons API deteksi citra EMO. Rasio aspek area ini adalah 1:1 atau 3:4. Format koordinat adalah [x1, y1, x2, y2], yang merepresentasikan koordinat titik kiri atas dan kanan bawah. Contoh: [71, 9, 840, 778].
parameters object (Opsional)

Properti

style_level string (Opsional) Nilai default: normalMengontrol gerakan dan amplitudo karakter. Tiga gaya didukung: normal untuk gerakan moderat, calm untuk gerakan tenang, dan active untuk gerakan aktif. Nilai default adalah normal.
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "emo-v1",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251225/onmomb/emo.png",
        "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250825/aejgyj/input_audio.mp3",
        "face_bbox":[302,286,610,593],
        "ext_bbox":[71,9,840,778]
        },
    "parameters": {
        "style_level": "normal"
        }
    }'

Parameter respons

outputobjectBerisi informasi output tugas.

Properti

task_idstringID tugas asinkron yang dikirimkan. Hasil tugas aktual harus diambil menggunakan API kueri tugas asinkron. Contoh: a8532587-fa8c-4ef8-82be-xxxxxx.task_status stringStatus tugas setelah dikirimkan. Contoh: "PENDING".
request_id stringID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan memecahkan masalah.code stringKode kesalahan yang dikembalikan ketika permintaan gagal. Untuk informasi lebih lanjut, lihat Kode kesalahan.messagestringPesan kesalahan detail yang dikembalikan ketika permintaan gagal. Untuk informasi lebih lanjut, lihat Kode kesalahan.
{
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "PENDING"
    },
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}

Langkah 2: Tanyakan hasil berdasarkan ID tugas

Gunakan task_id dari langkah sebelumnya untuk memantau status dan hasil tugas. Ganti {task_id} dalam URL dengan ID tugas aktual Anda. 
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
  • Validitas task_id: ID ini berlaku selama 24 jam setelah dibuat. Setelah periode ini, Anda tidak dapat lagi menanyakan hasilnya. API akan mengembalikan status tugas UNKNOWN.
  • Alur status tugas: Tugas yang diproses secara normal akan melewati status berikut: PENDING, RUNNING, dan SUCCEEDED atau FAILED.
  • Pengambilan hasil: Pembuatan video membutuhkan waktu beberapa menit. API kueri memiliki batas default 20 QPS. Gunakan mekanisme polling dengan interval kueri yang wajar, misalnya 15 detik, untuk mengambil hasil.
  • Validitas video_url: Setelah tugas berhasil, URL tersebut berlaku selama 24 jam. Anda harus segera mengunduh video dan memindahkannya ke penyimpanan permanen setelah menerima tautan tersebut (seperti Object Storage Service (OSS)).

Parameter permintaan

Header
Authorizationstring(Wajib)Digunakan untuk otentikasi identitas permintaan. API menggunakan kunci API Model Studio untuk autentikasi. Contoh: Bearer sk-xxxx.
Parameter path URL
task_id string(Wajib)task_id dari tugas yang ingin ditanyakan. Contoh: a8532587-fa8c-4ef8-82be-xxxxxx.
curl -X GET \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

Parameter respons

request_id stringID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan memecahkan masalah.outputobjectBerisi informasi output tugas.

Properti

task_idstringtask_id dari tugas yang ditanyakan. Contoh: a8532587-fa8c-4ef8-82be-xxxxxx.task_status stringStatus tugas.

Enumerasi

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN: Tugas tidak ada atau statusnya tidak dapat ditentukan.
submit_time stringWaktu saat tugas dikirimkan. Zona waktu adalah UTC+8. Contoh: 2025-09-11 14:33:38.716.scheduled_time stringWaktu saat tugas dijadwalkan untuk dimulai. Zona waktu adalah UTC+8. Contoh: 2025-09-11 14:33:53.089.end_time stringWaktu saat tugas selesai. Zona waktu adalah UTC+8. Contoh: 2025-09-11 14:35:51.541.results objectHasil eksekusi tugas.

Properti

video_url stringURL hasil video yang dihasilkan oleh platform. video_url berlaku selama 24 jam setelah tugas selesai. Anda harus segera mengunduh dan menyimpan file video tersebut. Contoh: http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=xxxx.
code stringKode kesalahan yang dikembalikan ketika permintaan gagal. Untuk informasi lebih lanjut, lihat Kode kesalahan.messagestringPesan kesalahan detail yang dikembalikan ketika permintaan gagal. Untuk informasi lebih lanjut, lihat Kode kesalahan.
usage object

Properti

video_duration floatDurasi video yang dihasilkan oleh permintaan ini, dalam detik. Contoh: 13,93.video_ratio stringRasio aspek video yang dihasilkan oleh permintaan ini. Nilainya adalah 1:1 atau 3:4.
{
    "request_id": "8190395f-ca1b-4703-9656-xxxxxx",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-11 14:33:38.716",
        "scheduled_time": "2025-09-11 14:33:53.089",
        "end_time": "2025-09-11 14:35:51.541",
        "results": {
            "video_url": "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=xxxx"
        }
    },
    "usage": {
        "video_duration": 13.93,
        "video_ratio": "1:1"
    }
}

Penagihan dan batas laju

Nama model

Harga satuan

Batas QPS pengiriman tugas

Tugas konkuren

emo-v1

Pay-as-you-go. Anda dikenai biaya berdasarkan durasi aktual video output:

  • Video rasio aspek 1:1: USD 0,011469 per detik

  • Video rasio aspek 3:4: USD 0,022937 per detik

5

1

(Tugas berlebih akan masuk antrian.)

Kode kesalahan

Untuk kode status umum, 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