Model teks ke video PixVerse menghasilkan video yang mulus berdasarkan prompt teks.
Aktifkan layanan
- Buka konsol Model Studio, cari PixVerse, temukan kartu model PixVerse, lalu klik Activate Now.
- Di jendela pop-up, konfirmasikan aktivasi dan otorisasi.
Catatan penggunaan
Agar panggilan API berhasil, gunakan model, URL endpoint, dan API key dari wilayah yang sama. Panggilan lintas wilayah akan gagal.
- Pilih model: Pastikan wilayah tempat model Anda berada.
- Pilih URL: Pilih URL endpoint wilayah yang sesuai. URL HTTP maupun DashScope SDK didukung.
- Konfigurasikan API key: Pilih wilayah, dapatkan API key, lalu konfigurasikan API key sebagai variabel lingkungan.
- Instal SDK: Untuk melakukan panggilan menggunakan SDK, instal DashScope SDK.
Contoh kode dalam topik ini berlaku untuk wilayah Singapura.
Panggilan HTTP
Pembuatan video dari teks adalah tugas yang berjalan lama dan biasanya memerlukan 1 hingga 5 menit, sehingga API menggunakan panggilan asinkron. Alurnya terdiri dari dua langkah utama: "Buat tugas -> Lakukan polling hasil". Langkah-langkahnya sebagai berikut:
Langkah 1: Buat tugas untuk mendapatkan ID tugas
Wilayah Singapura: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
- Setelah tugas dibuat, gunakan
task_idyang dikembalikan untuk mengueri hasil.task_idberlaku selama 24 jam. Jangan membuat tugas duplikat. Gunakan polling untuk mengambil hasilnya. - Untuk panduan pemula, lihat Memanggil API dengan Postman atau cURL.
Parameter permintaanHeaderContent-Typestring (Wajib)Jenis konten permintaan. Harus application/json.Authorization string (Wajib)Mengautentikasi permintaan dengan API key Model Studio. Contoh: Bearer sk-xxxx.X-DashScope-Async string (Wajib)Mengaktifkan pemrosesan asinkron. Permintaan HTTP hanya mendukung panggilan asinkron. Harus enable.Isi permintaanmodelstring (Wajib)Nama model.Nilai yang valid:
object (Wajib)Informasi input dasar, seperti prompt.
Properti prompt string (Wajib)Prompt teks yang menjelaskan elemen dan karakteristik visual yang diinginkan dalam video yang dihasilkan.Bahasa Mandarin dan Inggris didukung. Setiap karakter bahasa Mandarin atau huruf dihitung sebagai satu karakter. Pengodean karakternya adalah UTF-8. Karakter yang melebihi batas dipotong secara otomatis.
object (Wajib)Parameter pembuatan video, seperti resolusi video, durasi, dan apakah audio dihasilkan.
Properti size string (Wajib)Resolusi video yang dihasilkan, dalam format width*height dalam piksel.Tabel berikut mencantumkan nilai yang valid untuk berbagai tingkat resolusi dan rasio aspek.
Model pixverse/pixverse-v6-t2v
integer (Wajib)Durasi video yang dihasilkan, dalam detik.
boolean (Opsional)Menentukan apakah video dihasilkan dengan audio. Jika diaktifkan, model secara otomatis menghasilkan musik latar atau efek suara yang sesuai berdasarkan konten video.
boolean (Opsional)Menentukan apakah watermark ditambahkan. Watermark ditempatkan di sudut kanan bawah video dengan teks tetap "AI Generated".
string (Opsional)Model yang didukung: pixverse/pixverse-v6-t2v.Menentukan jenis shot video yang dihasilkan. Parameter ini mengontrol apakah video terdiri dari satu shot berkelanjutan atau beberapa shot.
integer (Opsional)Seed bilangan acak harus berupa bilangan bulat dalam rentang [0, 2147483647].Jika tidak ditentukan, seed acak akan dibuat. Seed tetap meningkatkan reproduktibilitas.Karena pembuatan oleh model bersifat probabilistik, seed yang sama tidak menjamin hasil identik. |
Model yang didukung: pixverse/pixverse-v6-t2v. |
Parameter responsoutputobjectInformasi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringPengidentifikasi permintaan unik untuk pelacakan dan pemecahan masalah.code stringKode kesalahan. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan terperinci. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan. |
Simpan task_id untuk mengueri status dan hasil tugas. |
Langkah 2: Kueri hasil berdasarkan ID tugas
Wilayah Singapura: GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}
- Rekomendasi polling: Pembuatan video dapat memerlukan beberapa menit. Gunakan mekanisme polling dan lakukan polling hasil dengan interval yang wajar, misalnya setiap 15 detik.
- Alur status tugas: PENDING (dalam antrean) → RUNNING (diproses) → SUCCEEDED (berhasil) / FAILED (gagal).
- Masa berlaku ID tugas:
task_idberlaku selama 24 jam. Setelah itu, kueri akan gagal dan API mengembalikan status tugasUNKNOWN. - Batas RPS: Endpoint kueri memiliki batas default 20 RPS. Untuk kueri berfrekuensi tinggi atau notifikasi peristiwa, konfigurasikan callback tugas asinkron.
- Operasi lainnya: Untuk melakukan kueri batch, membatalkan tugas, atau operasi lain, lihat Mengelola tugas asinkron.
Parameter permintaanHeaderAuthorizationstring (Wajib)Mengautentikasi permintaan dengan API key Model Studio. Contoh: Bearer sk-xxxx.Parameter jalurtask_idstring (Wajib)ID tugas. |
Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. |
Parameter responsoutputobjectInformasi output tugas.
Properti task_id stringID tugas. Berlaku untuk kueri selama 24 jam.task_status stringStatus tugas.
Nilai enumerasi
stringWaktu tugas dikirim. Format: YYYY-MM-DD HH:mm:ss.SSS.scheduled_time stringWaktu tugas dijalankan. Format: YYYY-MM-DD HH:mm:ss.SSS.end_time stringWaktu tugas selesai. Format: YYYY-MM-DD HH:mm:ss.SSS.video_url stringURL video. Hanya dikembalikan saat task_status adalah SUCCEEDED.Format video adalah MP4 (pengodean H.264). Saat ini tautan video tidak kedaluwarsa, tetapi tidak ditujukan untuk penyimpanan jangka panjang. Segera unduh video.orig_prompt stringPrompt input asli, sesuai parameter permintaan prompt.code stringKode kesalahan. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.message stringPesan kesalahan terperinci. Hanya dikembalikan untuk permintaan yang gagal. Lihat Kode kesalahan.objectStatistik penggunaan output, hanya dihitung untuk tugas yang berhasil.
Properti duration integerTotal durasi video yang dihasilkan dalam detik, digunakan untuk penagihan.size stringResolusi video yang dihasilkan.fps integerFrame rate video yang dihasilkan.SR stringTingkat resolusi video yang dihasilkan.audio booleanMenunjukkan apakah video yang dihasilkan memiliki audio.video_count integerJumlah video yang dihasilkan. Nilainya tetap 1.shot_type stringJenis shot video yang dihasilkan.stringPengidentifikasi permintaan unik untuk pelacakan dan pemecahan masalah. |
|
Panggilan DashScope SDK
Nama parameter dalam SDK sebagian besar konsisten dengan API HTTP. Struktur parameter disesuaikan dengan fitur setiap bahasa pemrograman.
Karena tugas teks ke video memerlukan waktu lama (biasanya 1 hingga 5 menit), SDK merangkum proses panggilan asinkron HTTP dan mendukung metode panggilan sinkron maupun asinkron.
Waktu aktual yang diperlukan bergantung pada jumlah tugas dalam antrean dan status eksekusi layanan. Harap bersabar menunggu hasilnya.
Panggilan SDK Python
Wilayah Singapura: region="ap-southeast-1"
Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh respons
Saat ini video_url tidak kedaluwarsa, tetapi tidak ditujukan untuk penyimpanan jangka panjang. Segera unduh video.
Panggilan SDK Java
Wilayah Singapura: Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda.
- Panggilan sinkron
- Panggilan asinkron
Contoh permintaan
Contoh respons
Saat ini video_url tidak kedaluwarsa, tetapi tidak ditujukan untuk penyimpanan jangka panjang. Segera unduh video.