Skip to main content
POST

Autentikasi

string
wajib
Semua endpoint memerlukan autentikasi menggunakan Bearer Token.Mendapatkan API Key:Kunjungi halaman pengelolaan API Key untuk mendapatkan API Key Anda.Tambahkan header berikut pada permintaan:

Parameter Permintaan

string
wajib
Nama model pembuatan video. Tetap pixverse-v6.
boolean
default:"false"
Menentukan apakah moderasi konten dijalankan sebelum tugas video dikirim.
  • true: periksa prompt dan gambar input dengan omni-moderation-latest
  • false atau dihilangkan: tidak mengirim permintaan moderasi, tanpa biaya atau latensi moderasi tambahan (default)
string
wajib
Deskripsi konten video, hingga 5000 karakter. Wajib di semua mode.
string
default:"540p"
Tingkat resolusi video. Memengaruhi penagihan secara langsung.
  • 360p: SD
  • 540p: Standar (default)
  • 720p: HD
  • 1080p: Full HD
Nilai resolusi lain akan mengembalikan kesalahan parameter.
integer
default:"5"
Durasi video dalam detik, rentang 1–15.
Mode transisi frame awal/akhir hanya mendukung 5 atau 8 detik.
string
default:"16:9"
Rasio aspek video. Hanya berlaku pada mode teks-ke-video dan fusi gambar referensi multipel.
  • 16:9: Lanskap layar lebar (default)
  • 4:3: Lanskap 4:3
  • 1:1: Persegi
  • 3:4: Potret 3:4
  • 9:16: Potret vertikal
  • 2:3: Potret 2:3
  • 3:2: Lanskap 3:2
  • 21:9: Sinema layar lebar
integer
default:"0"
Seed acak, rentang 0–2147483647. Prompt dan seed yang sama dapat menghasilkan kembali hasil yang serupa.
string
Prompt negatif untuk mengecualikan konten yang tidak diinginkan. Hingga 2048 karakter.
boolean
default:"false"
Apakah trek audio dihasilkan.
  • true: Hasilkan audio (menaikkan harga)
  • false: Tanpa audio (default)
boolean
default:"false"
Apakah watermark ditambahkan di pojok kanan bawah video.
  • true: Tambahkan watermark
  • false: Tanpa watermark (default)
string
Mode gerakan.
  • normal: Mode standar (pixverse-v6 hanya mendukung nilai ini)
fast hanya berlaku untuk model lama dan akan ditolak oleh upstream pada pixverse-v6.
boolean
default:"false"
Apakah menghasilkan video multi-klip yang berkelanjutan. Hanya didukung pada teks-ke-video dan gambar-ke-video.
  • true: Hasilkan video multi-klip berkelanjutan
  • false: Klip tunggal (default)
array<url>
Array URL gambar masukan untuk gambar-ke-video. Hanya gambar pertama yang digunakan.Gambar harus berupa URL HTTP/HTTPS yang dapat diakses publik.
url
URL frame awal pada mode transisi. Harus disertakan bersama last_frame_image.
url
URL frame akhir pada mode transisi. Harus disertakan bersama first_frame_image.
array<url>
Array URL gambar referensi untuk mode fusi gambar referensi multipel. Mendukung 1–7 gambar.Mengirimkan kolom ini akan memicu mode fusi gambar referensi multipel.
string
ID tugas sumber untuk perpanjangan video. Mengirimkan kolom ini akan memicu mode perpanjangan video.Tugas sumber harus milik pengguna saat ini, menggunakan model pixverse-v6, dan berstatus completed.

Mode Pembuatan

Adapter secara otomatis mengarahkan ke mode pembuatan yang sesuai berdasarkan kolom permintaan. Pencocokan dilakukan berdasarkan urutan prioritas; mode pertama yang cocok yang dipilih.
Semua input gambar hanya menerima URL HTTP/HTTPS yang dapat diakses publik. base64 atau Data URI tidak didukung. Jika Anda hanya memiliki gambar lokal, unggah dulu ke object storage lalu kirimkan URL-nya.

Aturan Parameter

Respons

integer
Kode status respons. 200 jika berhasil.
array
Array tugas yang dikembalikan.

Mengueri Hasil Tugas

Pembuatan video adalah tugas asinkron. Setelah pengiriman, task_id dikembalikan. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil.
cURL
Disarankan polling setiap 5 detik hingga status menjadi completed atau failed.

Contoh hasil sukses

URL video berada pada data.result.videos[0].url[0]. Kolom url itu sendiri merupakan array. Tautan video biasanya kedaluwarsa setelah 24 jam — segera unduh atau transfer.

Contoh hasil gagal

Saat gagal, cost umumnya 0. Penyebab kesalahan terdapat pada data.error.message.

Skenario Penggunaan

Skenario 1: Teks-ke-video

Skenario 2: Gambar-ke-video

Skenario 3: Transisi frame awal/akhir

Skenario 4: Fusi gambar referensi multipel

Skenario 5: Perpanjangan video