Skip to main content
POST

Autentikasi

string
wajib
Semua permintaan memerlukan autentikasi Bearer Token.Dapatkan API Key:Kunjungi halaman manajemen API Key untuk mendapatkan API Key Anda.Tambahkan header berikut saat membuat permintaan:

Parameter Permintaan

string
wajib
Nama model pembuatan video. Harus Omni-Flash-Ext.
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. Kami menyarankan untuk menjelaskan adegan, subjek, aksi, lingkungan, gerakan kamera, gaya visual, dan petunjuk audio secara detail.Contoh: "a girl is dancing happily in a sunny garden"
integer
default:"6"
Durasi video dalam detik.Nilai yang didukung: 4, 6, 8, 10.
Nilai lain seperti 5 atau 7 akan mengembalikan error invalid_duration error.
Jangan kirim duration saat mengunggah video referensi. duration dan video_urls tidak dapat dikirim bersamaan.
string
default:"720p"
Resolusi video. Nilai tidak peka huruf besar/kecil.Nilai yang didukung:
  • 720p
  • 1080p
  • 4k
Other resolutions akan mengembalikan error invalid_resolution error.
string
default:"16:9"
Rasio aspek video. Gunakan untuk mengontrol output lanskap atau potret.Nilai umum:
  • 16:9 - landscape
  • 9:16 - potret
Default: 16:9
string
Field kompatibilitas. Artinya sama dengan aspect_ratio. Jika keduanya disediakan, pastikan nilainya konsisten.
string
Tipe generasi, digunakan untuk menentukan cara gambar digunakan.Pilihan:
  • frame - Mode frame pertama. image_urls hanya dapat berisi 1 gambar, digunakan sebagai frame pertama video.
  • reference - Mode referensi. image_urls dapat berisi 1 atau 3 gambar, digunakan sebagai gambar referensi.
Ketika generation_type adalah frame, image_urls hanya mendukung 1 gambar; mengirim jumlah lain akan mengembalikan error unsupported_image_count.
array<url>
Array URL gambar referensi. Anda dapat menghilangkannya, menyediakan 1 gambar, atau menyediakan 3 gambar, tergantung pada generation_type:
  • Dihilangkan atau array kosong: Teks-ke-Video
  • 1 gambar: Gambar-ke-Video satu gambar
  • 3 gambar: fusi gambar referensi (hanya didukung ketika generation_type adalah reference)
Hubungan dengan generation_type:
  • generation_type adalah frame: hanya 1 gambar yang dapat diunggah.
  • generation_type adalah reference: 1 atau 3 gambar dapat diunggah.
Hanya URL gambar yang dapat diakses publik yang didukung.
Mode frame pertama plus frame terakhir dengan 2 gambar tidak didukung. Mengirim 2 gambar mengembalikan error unsupported_image_count error. 4 gambar atau lebih belum sepenuhnya diverifikasi dan tidak direkomendasikan.
array<url>
Array URL video referensi. Anda dapat menghilangkannya atau menyediakan 1 video referensi.Hanya URL video HTTP/HTTPS yang dapat diakses publik yang didukung. Anda dapat mengirimkannya bersama image_urls: gambar digunakan sebagai referensi identitas atau komposisi, sedangkan video digunakan sebagai referensi gerakan.
Omni-Flash-Ext hanya mendukung 0 atau 1 video referensi. Mengirim 2 video atau lebih akan mengembalikan error unsupported_video_count.
Jangan kirim duration saat mengirim video_urls. video_urls dan duration tidak dapat dikirim bersamaan.

Respons

integer
Respons status code. Successful requests mengembalikan 200.
array
Array tugas yang dikembalikan.

Kueri Hasil Tugas

Pembuatan video bersifat asinkron. Setelah pengiriman, API mengembalikan task_id. Gunakan endpoint Dapatkan status tugas untuk mengueri progres dan hasil.
cURL
Kami menyarankan menunggu 5-10 detik setelah pengiriman sebelum kueri pertama, lalu melakukan polling setiap 5-10 detik. Satu tugas biasanya selesai dalam sekitar 3-5 menit.

Contoh Hasil Berhasil

Gagal Hasil Example

Kasus Penggunaan

Skenario 1: Teks-ke-Video

Skenario 2: Video Satu Gambar

Skenario 3: Fusi 3 Gambar Referensi

Skenario 4: Video Pendek 4K

Skenario 5: Pembuatan dengan Video Referensi

Kode Error

Saat tugas gagal, API status tugas mengembalikan alasan kegagalan di data.error. Penyebab umum meliputi kuota upstream yang sementara habis, kegagalan moderasi konten, atau timeout upstream.