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 kinerja
Contoh masukan | Contoh keluaran |
Portret:
Audio suara: | Kekuatan gaya aksi: Parameter |
Untuk contoh lainnya, lihat Tampilan kinerja.
Pastikan semua citra dan file audio yang diunggah berasal dari sumber yang mematuhi hukum dan Anda memiliki izin yang diperlukan untuk penggunaannya.
Prasyarat
Anda harus mengaktifkan layanan model dan membuat kunci API, lalu mengekspor kunci API sebagai variabel lingkungan.
Anda dapat memproses citra masukan menggunakan API deteksi citra EMO untuk mendapatkan nilai koordinat face_bbox dan ext_bbox. Nilai-nilai ini digunakan sebagai parameter permintaan.
HTTP
Langkah 1: Buat tugas dan dapatkan ID tugas
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesisSetelah membuat tugas, sistem segera mengembalikan
task_id. Anda dapat menggunakan ID ini pada Langkah 2 untuk menanyakan hasil tugas.task_idberlaku selama 24 jam setelah dibuat.
Parameter permintaan | |
Header | |
X-DashScope-Async Parameter konfigurasi pemrosesan asinkron. Permintaan HTTP hanya mendukung pemrosesan asinkron. Anda harus mengatur parameter ini ke Penting Jika header permintaan ini tidak ada, pesan kesalahan "current user api does not support synchronous calls" akan dikembalikan. | |
Otorisasi Header ini digunakan untuk otentikasi identitas. API mengotentikasi permintaan menggunakan kunci API Model Studio. Contoh: Bearer sk-xxxx. | |
Content-Type Tipe konten permintaan. Atur parameter ini ke | |
Badan Permintaan | |
model Nama model. Contoh: emo-v1. | |
input Menentukan informasi masukan dasar. | |
parameters |
Parameter respons | Contoh respons suksesContoh respons kesalahan |
output Berisi informasi keluaran tugas. | |
request_id ID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan memecahkan masalah. | |
code Kode kesalahan yang dikembalikan ketika permintaan gagal. Untuk informasi selengkapnya, lihat Kode kesalahan. | |
message Pesan kesalahan terperinci yang dikembalikan ketika permintaan gagal. Untuk informasi selengkapnya, lihat Kode kesalahan. |
Langkah 2: Kueri hasil berdasarkan ID tugas
Gunakan task_id dari langkah sebelumnya untuk melakukan polling 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 mengembalikan status tugas
UNKNOWN.Alur status tugas: Tugas yang diproses secara normal melewati status berikut: `PENDING`, `RUNNING`, dan `SUCCEEDED` atau `FAILED`.
Pengambilan hasil: Pembuatan video memerlukan waktu beberapa menit. API kueri memiliki batas default 20 QPS. Gunakan mekanisme polling dengan interval kueri yang wajar, misalnya 15 detik, untuk mengambil hasilnya.
Validitas video_url: Setelah tugas berhasil, URL 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 | |
Otorisasi Digunakan untuk otentikasi identitas permintaan. API menggunakan kunci API Model Studio untuk otentikasi. Contoh: Bearer sk-xxxx. | |
Parameter jalur URL | |
task_id `task_id` dari tugas yang akan ditanyakan. Contoh: a8532587-fa8c-4ef8-82be-xxxxxx. |
Parameter respons | Contoh respons suksesContoh respons kesalahan |
request_id ID permintaan unik. Anda dapat menggunakan ID ini untuk melacak dan memecahkan masalah. | |
output Berisi informasi keluaran tugas. | |
usage |
Penagihan dan batas laju
Model | Harga satuan | Batas QPS pengiriman tugas | Tugas konkuren |
emo-v1 | Bayar sesuai pemakaian. Anda dikenai biaya berdasarkan durasi aktual video keluaran:
| 5 | 1 (Tugas berlebih akan masuk antrian.) |
Kode kesalahan
Untuk kode status umum, lihat Pesan kesalahan.
Model ini juga memiliki kode kesalahan spesifik berikut:
Kode balasan HTTP | Kode | Pesan | Deskripsi |
400 | InvalidParameter | The request is missing required parameters or in a wrong format, please check the parameters that you send. | Format parameter masukan salah. |
400 | InvalidParameter | The style_level is invalid. | Nilai `style_level` tidak berada dalam rentang enumerasi. |
400 | InvalidParameter.DataInspection | Unable to download the media resource during the data inspection process. | Terjadi timeout saat sistem mengunduh file citra atau audio. Jika Anda melakukan panggilan dari luar Tiongkok, timeout pengunduhan sumber daya dapat terjadi karena jaringan lintas batas yang tidak stabil. Anda dapat menyimpan file di OSS di Tiongkok lalu memanggil model tersebut. Anda juga dapat menggunakan ruang penyimpanan sementara untuk mengunggah file. |
400 | InvalidURL | The request URL is invalid, please check the request URL is available and the request image format is one of the following types: JPEG, JPG, PNG, BMP, and WEBP. | Gagal mengunduh citra masukan. Periksa jaringan atau format masukan. Format yang didukung: JPEG, JPG, PNG, BMP, dan WEBP. |
400 | InvalidURL | Required URL is missing or invalid, please check the request URL. | URL masukan salah atau tidak ada. |
400 | InvalidURL | The input audio is longer than 60s! | File audio masukan melebihi durasi maksimum 60 detik. |
400 | InvalidURL | File size is larger than 15MB. | File audio masukan melebihi ukuran maksimum 15 MB. |
400 | InvalidURL | File type is not supported. Allowed types are: .wav, .mp3. | Format audio masukan tidak valid. Format yang didukung adalah WAV dan MP3. |
400 | InvalidFile.Content | The input image has no human body. Please upload other image with single person. | Tidak ada orang yang ditemukan dalam citra masukan. Unggah citra yang berisi seseorang. |
400 | InvalidFile.Content | The input image has multi human bodies. Please upload other image with single person. | Beberapa orang ditemukan dalam citra masukan. Unggah citra yang hanya berisi satu orang. |
400 | InvalidFile.BodyProportion | The proportion of the detected person in the picture is too large or too small, please upload other image. | Proporsi orang dalam citra masukan tidak memenuhi persyaratan. |
400 | InvalidFile.Resolution | The image resolution is invalid, please make sure that the largest length of image is smaller than 7000, and the smallest length of image is larger than 400. | Resolusi citra tidak valid. Panjang sisi minimum harus setidaknya 400 piksel, dan panjang sisi maksimum tidak boleh melebihi 7.000 piksel. |
400 | InvalidFile.Value | The value of the image is invalid, please upload other clearer image. | Citra masukan terlalu gelap dan tidak memenuhi persyaratan. Unggah citra yang lebih jelas. |
400 | InvalidFile.FrontBody | The pose of the detected person is invalid, please upload other image with the front view. | Orang dalam citra yang diunggah menghadap menjauh dari kamera, yang tidak memenuhi persyaratan. Unggah citra dengan tampilan depan orang tersebut. |
400 | InvalidFile.FullFace | The pose of the detected face is invalid, please upload other image with whole face. | Pose wajah orang dalam citra yang diunggah tidak memenuhi persyaratan. Unggah citra di mana wajah terlihat. |
400 | InvalidFile.FacePose | The pose of the detected face is invalid, please upload other image with the expected orientation. | Pose wajah orang dalam citra yang diunggah tidak memenuhi persyaratan. Unggah citra di mana wajah tidak memiliki offset orientasi yang parah. |
