Skip to main content
POST

Otorisasi

string
wajib
Semua endpoint API memerlukan autentikasi Bearer TokenDapatkan API Key Anda:Kunjungi Halaman Manajemen API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan:

Parameter Permintaan

string
wajib
Nama model pembuatan videoModel yang tersedia:
  • veo3.1-fast-official - Veo 3.1 Resmi Versi Cepat
  • veo3.1-quality-official - Veo 3.1 Resmi Versi Kualitas Tinggi
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
Prompt teks positifJelaskan adegan, aksi, gaya, dan lainnya secara detail untuk hasil pembuatan yang lebih baik. Prompt berbahasa Inggris direkomendasikan.Contoh: "a golden retriever running on the beach, sunset, cinematic"
string
Prompt negatif untuk mengecualikan konten yang tidak diinginkanContoh: "blurry, low quality, watermark, text"
integer
default:"8"
Durasi video dalam detikNilai yang direkomendasikan: 4 / 6 / 8Default: 8Catatan: Harus berupa angka murni (misalnya 8), jangan tambahkan tanda kutip, jika tidak error akan terjadi
string
default:"16:9"
Rasio aspek videoNilai yang tersedia:
  • 16:9 - Lanskap
  • 9:16 - Potret
Default: 16:9
string
default:"720p"
Resolusi videoNilai yang tersedia:
  • 720p - Resolusi standar
  • 1080p - Definisi tinggi
  • 4K - Definisi ultra tinggi
Default: 720p
string
URL gambar frame pertama untuk pembuatan gambar-ke-video
  • URL gambar harus dapat diakses publik tanpa proteksi hotlink
  • URL object storage lebih direkomendasikan daripada tautan unduhan sementara
string
URL gambar frame terakhir untuk pembuatan gambar-ke-videoDigunakan bersama first_frame_image untuk mengontrol frame pertama dan terakhir
integer
Seed acak untuk mereproduksi hasil pembuatanRentang nilai: 0 - 4294967295
integer
default:"1"
Jumlah sampel yang akan dihasilkan (1-4), saat ini direkomendasikan untuk menggunakan 1Default: 1
boolean
default:"false"
Apakah membuat trek audio
string
default:"allow_adult"
Kebijakan pembuatan orangNilai yang tersedia:
  • allow_adult - Hanya mengizinkan pembuatan orang/wajah dewasa
  • disallow - Tidak mengizinkan pembuatan orang atau wajah
Default: allow_adult
string
default:"pad"
Strategi pengubahan ukuran gambar (berlaku untuk gambar-ke-video)Nilai yang tersedia:
  • pad - Mode padding
  • crop - Mode cropping
Default: pad
boolean
default:"true"
Apakah mengaktifkan peningkatan prompt upstreamDefault: true
  • Parameter ini hanya dapat diatur ke true. Mengaturnya ke false akan menyebabkan error permintaan
  • Jika Anda tidak memerlukan parameter ini, jangan sertakan

Teks-ke-Video vs Gambar-ke-Video

Sistem otomatis menentukan mode berdasarkan apakah parameter gambar disediakan: tanpa gambar untuk teks-ke-video, dengan gambar untuk gambar-ke-video.

Respons

integer
Kode status respons, 200 jika berhasil
array
Array data respons

Skenario Penggunaan

Skenario 1: Teks-ke-Video (Dasar)

Skenario 2: Teks-ke-Video (Parameter Lengkap)

Skenario 3: Gambar-ke-Video (Frame Pertama Tunggal)

Skenario 4: Gambar-ke-Video (Frame Pertama + Frame Terakhir)

Skenario 5: Video dengan Audio

Kueri Hasil TugasPembuatan video adalah tugas asinkron yang mengembalikan task_id saat dikirim. Gunakan endpoint Dapatkan Status Tugas untuk mengueri progres dan hasil pembuatan.