Akses Veo API terlihat sederhana jika Anda hanya membaca nama modelnya. Dalam produksi, ini adalah alur kerja video dengan pemeriksaan siklus hidup model, harga per detik, operasi asinkron, pilihan resolusi, biaya retry, dan observabilitas di level rute. Jika tim Anda membandingkan Veo dengan Seedance, rute bergaya Sora, atau model video lain di balik satu gateway, perlakukan akses sebagai daftar periksa, bukan sebagai penggantian API satu baris.
Panduan ini dicek pada 17 Juni 2026 Asia/Shanghai terhadap dokumentasi video Veo Gemini API Google, tabel harga Veo 3.1 Google, run Ahrefs MCP yang baru, dan snapshot katalog harga Flatkey yang live. Tujuannya bukan untuk mengklaim bahwa setiap rute siap produksi hari ini. Tujuannya adalah untuk menunjukkan persis apa yang harus diverifikasi sebelum Anda mengirim pekerjaan video berbayar melalui router multi-penyedia.
Jawaban Singkat: Apa yang Perlu Dicek untuk Akses Veo API
Sebelum menyetujui akses Veo API untuk traffic produksi, konfirmasikan tujuh hal berikut:
- ID model resmi: tentukan apakah alur kerja memerlukan
veo-3.1-generate-preview,veo-3.1-fast-generate-preview, atauveo-3.1-lite-generate-preview. - Status siklus hidup: hindari ID Veo 3.0 dan Veo 2.0 yang lebih lama kecuali Anda sedang menangani migrasi singkat, karena Google mencantumkannya untuk penutupan pada 30 Juni 2026.
- Satuan harga: normalisasi Veo berdasarkan detik, resolusi, dan varian sebelum membandingkannya dengan penyedia video berbasis token/resource pack.
- Jalur job asinkron: catat nama operasi, status polling, jumlah video akhir, durasi, resolusi, jumlah retry, dan alasan kegagalan.
- Baris katalog Flatkey: verifikasi baris model yang tepat, keluarga endpoint, grup, label harga, dan status ketersediaan pada hari Anda merutekan traffic.
- Aturan fallback: tentukan kapan job Veo yang gagal boleh beralih ke rute lain, dan kapan harus gagal tertutup demi alasan kualitas atau anggaran.
- Bukti penggunaan: jalankan tes kecil dan pastikan dashboard menampilkan model yang dipilih, rute, status, unit yang ditagihkan, dan pemilik biaya.
Itulah versi praktis dari akses Veo API: bukan sekadar "apakah saya bisa memanggil Veo," melainkan "apakah saya bisa membuktikan rute video mana yang berjalan, berapa biayanya, dan apa yang terjadi saat gagal."
Daftar Periksa Akses Veo API
| Item Daftar Periksa | Mengapa Ini Penting | Bukti yang Harus Disimpan |
|---|---|---|
| ID Model | Varian Veo tidak dapat saling dipertukarkan untuk biaya, latensi, resolusi, atau dukungan rute. | ID model resmi Google beserta baris Flatkey yang cocok. |
| Keluarga endpoint | Rute video mungkin tidak berperilaku seperti chat completion, meskipun gateway mengekspos surface yang kompatibel dengan OpenAI. | Jenis endpoint, template request, parameter yang diterima, dan bentuk respons. |
| Satuan harga | Veo dicantumkan per detik, sementara penyedia video lain dapat menggunakan token, media yang dihasilkan, atau resource pack. | Varian, resolusi, detik yang diharapkan, kebijakan retry, dan tanggal sumber harga. |
| Pencatatan operasi asinkron | Generasi Veo menggunakan alur submit-and-poll, sehingga satu tindakan pengguna dapat membuat beberapa event internal. | ID operasi, jumlah percobaan polling, status akhir, metadata video yang dihasilkan, dan jumlah retry. |
| Status ketersediaan | Baris katalog tidak sama dengan rute produksi yang berhasil. | Status dashboard, waktu pengecekan terakhir, respons tes, dan entri log penggunaan. |
| Batas fallback | Beralih model video dapat mengubah gaya, durasi, kualitas, perilaku kebijakan, dan biaya. | Matriks fallback yang disetujui dan kondisi fail-closed. |
Konfirmasikan Model Veo Resmi dan Siklus Hidupnya
Dokumentasi Gemini API Google saat ini menggunakan veo-3.1-generate-preview dalam contoh generasi Veo. Tabel harga mencantumkan tiga ID preview Veo 3.1: veo-3.1-generate-preview, veo-3.1-fast-generate-preview, dan veo-3.1-lite-generate-preview. Ini adalah tempat pertama untuk memulai peninjauan akses Veo API, karena katalog gateway dapat berisi ID lama, alias, dan label khusus penyedia pada saat yang sama.
Siklus hidup sama pentingnya dengan ID saat ini. Halaman harga Google yang dicek untuk artikel ini memperingatkan bahwa model Veo 3 veo-3.0-generate-001 dan veo-3.0-fast-generate-001 sudah tidak digunakan lagi dan dijadwalkan untuk dimatikan pada 30 Juni 2026. Halaman itu juga menyatakan bahwa Veo 2 veo-2.0-generate-001 sudah tidak digunakan lagi dan dijadwalkan untuk penutupan yang sama pada 30 Juni 2026. Jika contoh kode lama, rute tersimpan, atau favorit dashboard masih mengarah ke sana, perlakukan itu sebagai tugas migrasi, bukan jalur akses yang disetujui.
Normalisasi Harga Veo API Sebelum Anda Membandingkan Rute
Untuk akses Veo API, harga utama hanya berguna setelah Anda menormalkan request. Harga berbayar Veo 3.1 saat ini dari Google dicantumkan per detik dalam USD, dengan baris terpisah untuk varian Standard, Fast, dan Lite.
| Varian Veo 3.1 | ID Model Resmi | Harga yang Dicek | Catatan Perencanaan |
|---|---|---|---|
| Standard | veo-3.1-generate-preview |
$0.40/detik pada 720p atau 1080p; $0.60/detik pada 4K. | Gunakan saat persyaratan kualitas membenarkan baris default yang lebih tinggi. |
| Fast | veo-3.1-fast-generate-preview |
$0.10/detik pada 720p; $0.12/detik pada 1080p; $0.30/detik pada 4K. | Uji kualitas output dan latensi sebelum merutekan pekerjaan yang berhadapan dengan pengguna ke sini. |
| Lite | veo-3.1-lite-generate-preview |
$0.05/detik pada 720p; $0.08/detik pada 1080p; 4K tidak didukung. | Berguna untuk draf berbiaya lebih rendah ketika 4K tidak diperlukan. |
Halaman harga Google juga mencatat bahwa Anda hanya dikenai biaya jika video berhasil dihasilkan. Itu tidak menghilangkan kebutuhan untuk mencatat percobaan ulang. Operasi yang gagal, prompt yang berubah, atau eksekusi ulang yang diminta pengguna masih dapat menghasilkan pekerjaan berbayar lainnya nanti. Daftar periksa akses Veo API Anda harus mencakup durasi, resolusi, varian, status berhasil, dan jumlah percobaan ulang untuk setiap permintaan.
Jika Anda membandingkan Veo dengan penyedia lain, gunakan perbandingan harga API generasi video AI yang lebih luas sebagai hub normalisasi. Jangan membandingkan baris per detik Veo secara langsung dengan penyedia token/paket sumber daya tanpa menerjemahkan bentuk permintaan yang sebenarnya.
Perlakukan Generasi Veo Sebagai Operasi Jangka Panjang
Panduan Veo dari Google menunjukkan alur operasi jangka panjang: kirim permintaan generasi, polling operasi sampai selesai, lalu ambil video yang dihasilkan. Itu membuat akses Veo API berbeda dari permintaan teks biasa satu respons. Router dan dasbor Anda perlu mempertahankan status pekerjaan di seluruh polling, bukan hanya menangkap panggilan HTTP pertama.
Log yang siap produksi harus menjawab pertanyaan-pertanyaan ini:
- Aplikasi, kunci tim, lingkungan, dan alur kerja mana yang membuat pekerjaan video tersebut?
- ID model Veo, rasio aspek, resolusi, jenis prompt, dan media input apa yang digunakan?
- ID operasi atau handle asinkron setara apa yang dikembalikan?
- Berapa banyak percobaan polling yang berjalan sebelum selesai atau gagal?
- Apakah pekerjaan berhasil, gagal, dibatalkan, dicoba ulang, atau dirutekan ke tempat lain?
- Berapa banyak video yang dihasilkan yang dikembalikan, dan di mana output disimpan?
- Catatan penggunaan dan catatan biaya mana yang dapat direkonsiliasi oleh finance nanti?
Ini juga tempat kompatibilitas endpoint perlu diuji secara nyata. Sebuah gateway dapat mengekspos base URL yang kompatibel dengan OpenAI untuk banyak keluarga model, tetapi generasi video sering memiliki bidang khusus penyedia dan semantik asinkron. Simpan cuplikan kode sebagai template sampai Anda telah menguji kunci Flatkey terkini, baris model Veo terkini, dan body permintaan persis yang akan digunakan aplikasi Anda.
Verifikasi Baris Katalog Flatkey Sebelum Produksi
Katalog harga publik Flatkey diperiksa untuk artikel ini pada 17 Juni 2026 Asia/Shanghai. Responsnya memuat 638 baris model dan versi harga a42d372ccf0b5dd13ecf71203521f9d2. Baris terkait Veo hadir, termasuk ID bergaya Google dan alias seperti veo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-preview, veo3.1, veo3.1-fast, dan veo3.1-pro.
Peringatan penting: setiap baris Veo yang diperiksa dalam snapshot itu menunjukkan status ketersediaan unknown_failure. Artinya artikel ini dapat menggunakan baris tersebut sebagai bukti katalog bertanggal, tetapi tidak boleh mengklaim kesiapan produksi langsung. Alur kerja akses Veo API yang tepat adalah membuka halaman harga Flatkey terkini, mengonfirmasi baris yang tepat, memverifikasi label dasbor, memeriksa keluarga endpoint, dan menjalankan smoke test kecil sebelum mengirim lalu lintas produksi.
| Baris Flatkey yang Dicek | Jenis Endpoint yang Terlihat | Bidang Harga yang Terlihat | Status dalam Snapshot |
|---|---|---|---|
veo-3.1-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.4 |
unknown_failure |
veo-3.1-fast-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.15 |
unknown_failure |
veo-3.1-lite-generate-preview |
gemini, openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
veo3.1, veo3.1-fast, veo3.1-pro |
openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
Salinan produk publik Flatkey mendukung cerita routing yang hati-hati: satu API key, harga yang jelas, penagihan terpadu, dasbor untuk kunci, penggunaan, dan routing, serta bahasa switching/load balancing otomatis. Jaga pembuktian implementasi lebih sempit daripada janji pemasaran. Untuk akses Veo API, tes penerimaan harus berupa catatan permintaan nyata yang didukung dasbor, bukan hanya baris katalog.
Tetapkan Aturan Routing Video Multi-Penyedia
Failover video lebih sensitif daripada failover teks. Jika sebuah pekerjaan Veo gagal, beralih ke penyedia lain dapat mengubah durasi, gaya visual, interpretasi prompt, filter konten, format output, dan harga. Rencana akses Veo API harus mendefinisikan kapan fallback otomatis aman dan kapan alur kerja harus berhenti untuk tinjauan manusia.
| Situasi | Keputusan Routing yang Disarankan | Alasan |
|---|---|---|
| Kesalahan penyedia sementara atau timeout | Coba sekali lagi atau beralih ke rute ekuivalen yang disetujui jika alur kerja mengizinkannya. | Melindungi pengalaman pengguna tanpa menyembunyikan kegagalan berulang. |
| ID model yang sudah usang | Blokir rute dan migrasikan ke model saat ini sebelum trafik produksi. | Mencegah ketergantungan diam-diam pada rute dengan tanggal penghentian tetap. |
| Parameter permintaan yang tidak didukung | Gagal tertutup dan perbaiki permintaan klien. | Fallback buta biasanya mengulangi permintaan buruk yang sama di tempat lain. |
| Render akhir resolusi tinggi | Memerlukan persetujuan eksplisit untuk fallback ke rute yang lebih mahal. | Resolusi dan durasi dengan cepat melipatgandakan biaya video. |
| Draft atau iterasi kreatif internal | Izinkan fallback berbiaya lebih rendah hanya jika perbedaan output dapat diterima. | Alur kerja draft dapat menoleransi variasi yang lebih besar daripada output yang menghadap pelanggan. |
Bagian keandalan dari keputusan ini dibahas lebih mendalam dalam playbook load balancing dan failover AI API. Untuk video, tambahkan batasan biaya dan output kreatif ke setiap tangga fallback.
Jalankan Smoke Test Ini Sebelum Peluncuran
Smoke test akses Veo API yang bertanggung jawab harus kecil, terkontrol, dan mudah diperiksa:
- Buat atau pilih kunci Flatkey non-produksi.
- Pilih satu baris Veo terkini dari halaman harga langsung dan catat label model persisnya.
- Konfirmasikan keluarga endpoint dan template permintaan dengan pemilik produk/dokumentasi.
- Jalankan satu pekerjaan video berisiko rendah dengan pengaturan durasi dan resolusi yang diketahui.
- Catat operation ID, path polling status, hasil akhir, unit yang dapat ditagih, dan entri usage log.
- Ulangi dengan satu kegagalan terkontrol jika memungkinkan, seperti model deprecated yang diblokir atau parameter yang tidak didukung.
- Tentukan apakah rute dapat melayani trafik produksi, hanya staging, atau hanya backlog riset.
Jika salah satu pemeriksaan itu gagal, jangan gunakan rute tersebut di produksi. Usage log yang hilang, unit harga yang tidak jelas, atau status ketersediaan unknown_failure bukanlah masalah administrasi untuk video; itu mengubah biaya, dukungan, dan ekspektasi pelanggan.
FAQ
Bagaimana cara mendapatkan akses Veo API?
Mulailah dengan dokumentasi Gemini API Veo terbaru dari Google dan persyaratan penagihannya, lalu verifikasi model ID, endpoint, dan harga pada hari Anda membangun. Jika Anda menggunakan Flatkey untuk routing, periksa katalog harga dan dashboard saat ini sebelum menganggap akses Veo API siap produksi.
Model ID Veo mana yang harus saya gunakan?
Tabel harga Veo 3.1 terbaru dari Google mencantumkan veo-3.1-generate-preview, veo-3.1-fast-generate-preview, dan veo-3.1-lite-generate-preview. Hindari ID Veo 3.0 dan Veo 2.0 yang lebih lama untuk pekerjaan produksi baru karena Google mencantumkannya untuk penghentian pada 30 Juni 2026.
Bagaimana harga Veo API dihitung?
Google mencantumkan harga tier berbayar Veo 3.1 per detik, dengan tarif yang berbeda حسب varian dan resolusi. Untuk akses Veo API, normalisasikan detik yang diharapkan, resolusi, kebijakan keberhasilan, dan percobaan ulang sebelum membandingkan rute dengan penyedia video berbasis token atau resource-pack.
Bisakah Veo dirouting bersama model pembuatan video lain?
Ya, tetapi hanya setelah Anda mendefinisikan kontrak rute. Fallback dari Veo ke model video lain dapat mengubah kualitas visual, durasi, format output, perilaku moderasi, dan biaya. Gunakan aturan fallback yang disetujui, bukan retry otomatis generik.
Apa yang harus diverifikasi pengguna Flatkey sebelum produksi?
Verifikasi baris model saat ini, keluarga endpoint, label dashboard, status ketersediaan, label harga, field usage log, dan hasil smoke test yang nyata. Dalam snapshot 17 Juni 2026 yang digunakan untuk artikel ini, baris Veo memang ada tetapi menunjukkan unknown_failure, jadi penggunaan produksi memerlukan konfirmasi terbaru.
Inti Kesimpulan
Akses Veo API adalah keputusan produksi, bukan sekadar kotak centang penyedia. Konfirmasikan model resmi, normalkan detik dan resolusi, tangani pekerjaan asinkron, verifikasi baris Flatkey saat ini dan bukti dashboard, dan dokumentasikan batas fallback sebelum permintaan video yang menghadap pelanggan pertama.
Untuk mengevaluasi Veo bersama tumpukan model video Anda yang lain, mulailah dengan katalog harga Flatkey saat ini dan gunakan daftar periksa di atas untuk menentukan rute mana yang siap untuk staging, mana yang perlu smoke test, dan mana yang harus tetap berada di backlog riset.
