Skip to main content
POST

Autentikasi

string
wajib
Semua endpoint memerlukan autentikasi menggunakan 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, tetap gemini-omni-flash-preview.
string
wajib
Instruksi teks. Untuk Teks-ke-Video berupa deskripsi adegan; untuk Gambar / Video-ke-Video berupa instruksi aksi / gaya / pengeditan.
prompt dan materi referensi (image_urls / video_urls) setidaknya salah satu harus disediakan.
array<string>
Gambar referensi, maksimal 16 gambar. Setiap item berupa URL http(s)://.Mendukung JPEG / PNG. Untuk multi-subjek (seperti “kucing + bola benang”) Anda dapat mengirim beberapa gambar, dan jelaskan bagaimana mereka berinteraksi di dalam prompt.
array<string>
Video referensi / yang akan diedit, maksimal 1 video (tidak mendukung referensi multi-video). Dapat berupa tautan langsung http(s):// atau data:video/....
  • Video referensi 1 ~ 24 detik, disarankan secara resmi ≤3 detik.
  • video_urls dan extend_from_task_id bersifat saling eksklusif; berikan hanya salah satunya, tidak boleh keduanya sekaligus.
string
default:"16:9"
Rasio aspek video, benar-benar mengontrol orientasi tampilan output.
Saat video_urls diberikan, parameter aspect_ratio tidak berlaku.
Hanya mendukung:
  • 16:9 - lanskap (default)
  • 9:16 - potret
Nilai lain diperlakukan sebagai 16:9.
string
default:"720p"
Resolusi video. Saat ini hanya mendukung 720p.
string
ID tugas sebelumnya: isi dengan ** task_id** dari tugas pembuatan sebelumnya.
extend_from_task_id dan video_urls bersifat saling eksklusif; berikan hanya salah satunya, tidak boleh keduanya sekaligus.

Respons

integer
Kode status respons, 200 saat berhasil.
array
Mengembalikan array tugas.

Kueri Hasil Tugas

Pembuatan video merupakan tugas asinkron. Setelah pengiriman, API mengembalikan task_id. Gunakan endpoint Dapatkan status tugas untuk mengueri progres dan hasil pembuatan.

Contoh Hasil Berhasil

Kasus Penggunaan

Skenario 1: Teks-ke-Video

Skenario 2: Gambar-ke-Video

Skenario 3: Video-ke-Video