Skip to main content
POST

Autentikasi

string
wajib
Semua API memerlukan autentikasi Bearer Token.Dapatkan kunci API:Kunjungi halaman pengelolaan kunci API untuk mendapatkan kunci API Anda.Tambahkan ke header permintaan saat digunakan:

Parameter permintaan

string
wajib
Nama model pembuatan video. Harus gemini-omni-1.1-flash.
string
Instruksi teks. Untuk teks-ke-video, jelaskan adegan. Untuk gambar-ke-video, pengeditan, atau perpanjangan video, jelaskan gerakan, gaya, atau perubahan yang diinginkan.
Berikan setidaknya prompt atau media (image_urls, gambar frame awal/akhir, atau video_urls).
string
default:"720p"
Resolusi video keluaran. Huruf besar dan kecil tidak dibedakan.Nilai yang tersedia:
  • 360p
  • 720p (default)
  • 1080p
  • 4k
2160p diperlakukan sebagai 4k. Resolusi menentukan tingkat deposit yang ditahan dan biaya utama keluaran video.
Resolusi yang tidak didukung akan mengembalikan error invalid_resolution.
string
default:"16:9"
Rasio aspek video untuk memilih keluaran lanskap atau potret.Didukung:
  • 16:9 - Lanskap (default)
  • 9:16 - Potret
Nilai lain diperlakukan sebagai 16:9.
Saat video_urls diberikan, keluaran biasanya mengikuti rasio aspek video masukan sehingga aspect_ratio mungkin tidak diterapkan.
array<string>
Array gambar referensi. Hanya URL HTTP/HTTPS yang dapat diakses publik yang didukung.
  • Berikan 1 gambar: digunakan sebagai frame awal video secara default
  • Berikan beberapa gambar: digunakan sebagai referensi subjek atau gaya; jelaskan tujuan dan hubungan setiap gambar dalam prompt
image_urls dan gambar frame awal/akhir dibatasi maksimal 10 gambar secara total.
string
Gambar frame awal. Hanya URL HTTP/HTTPS yang dapat diakses publik yang didukung.
  • Diberikan sendiri: menggunakan gambar sebagai frame awal video
  • Diberikan bersama last_frame_image: membuat transisi video yang mulus dari frame awal ke frame akhir
string
Gambar frame akhir. Hanya URL HTTP/HTTPS yang dapat diakses publik yang didukung dan harus diberikan bersama first_frame_image.
Memberikan hanya last_frame_image akan mengembalikan invalid_frame_images. Gunakan rasio yang sama untuk kedua gambar dan samakan dengan aspect_ratio.
Untuk frame awal atau pasangan frame awal/akhir, kedua metode berikut memberikan hasil yang sama. Pilih salah satu dan jangan berikan keduanya:
  • Gunakan first_frame_image / last_frame_image
  • Gunakan image_with_roles dengan role diatur ke first_frame / last_frame
array<object>
Array gambar dengan peran. Ini adalah alternatif yang setara dengan first_frame_image / last_frame_image dan juga dapat mendeklarasikan gambar referensi.Contoh:
Jika image_urls juga diberikan, parameter tersebut diprioritaskan untuk referensi dan tidak digabungkan dengan referensi dalam image_with_roles. Semua gambar yang benar-benar digunakan, termasuk frame awal dan akhir, dibatasi maksimal 10 secara total.
array<string>
Array video yang akan diedit atau diperpanjang. Saat ini maksimal satu video dapat diberikan dan durasinya tidak boleh lebih dari 10 detik.Hanya URL langsung video HTTP/HTTPS yang dapat diakses publik yang didukung. Tautan YouTube tidak didukung.
video_urls dan extend_from_task_id saling eksklusif. Berikan hanya salah satu.
object
Objek parameter tambahan untuk menentukan tujuan pembuatan secara eksplisit.
Untuk interpolasi frame awal dan akhir, model menyimpulkan jenis tugas secara otomatis dan platform tidak meneruskan metadata.task.
string
task_id lokal dari tugas pembuatan sebelumnya. Gunakan untuk pengeditan percakapan atau perpanjangan lanjutan tanpa mengunggah ulang video sebelumnya.Tugas yang dirujuk harus milik pengguna saat ini, berstatus berhasil, dan merupakan tugas model Gemini Omni.
extend_from_task_id dan video_urls saling eksklusif. Berikan hanya salah satu.
Model ini tidak memiliki parameter duration. Durasi setiap keluaran ditentukan secara otomatis berdasarkan konten, biasanya 3–10 detik. Untuk mengatur tempo, jelaskan dalam prompt menggunakan bahasa alami atau rentang waktu.

Respons

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

Melihat hasil tugas

Pembuatan video berjalan asinkron. Setelah menerima task_id, gunakan API Dapatkan status tugas untuk melihat progres dan hasil.
cURL
Lakukan polling setiap 5–10 detik dan berhenti saat status menjadi completed atau failed. Batas waktu keseluruhan klien yang disarankan adalah 10 menit.

Contoh hasil berhasil

Kasus penggunaan

Kasus 1: teks-ke-video (4K)

Kasus 2: interpolasi frame awal dan akhir

Kasus 3: referensi multi-subjek

Kasus 4: mendeklarasikan frame awal dan akhir dengan peran gambar

Kasus 5: pengeditan video

Gunakan prompt singkat dan spesifik untuk pengeditan video. Untuk mengubah hanya satu bagian, tambahkan Keep everything else the same agar bagian lainnya tetap konsisten.

Kasus 6: perpanjangan percakapan