Akses Veo API bukan lagi sekadar pertukaran model satu baris untuk tim media. Sebelum Anda menempatkan traffic kreator di belakang model video Google, Anda perlu memverifikasi model ID, akses langsung ke penyedia, unit harga, perilaku job async, status rute, kebijakan fallback, dan bukti penggunaan pasca-generasi. Itulah tujuan dari Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia ini.
Gunakan daftar periksa ini ketika Anda memutuskan apakah Veo harus menjadi rute video default Anda, salah satu rute dalam kebijakan multi-penyedia, atau alur kerja Google langsung yang berada di luar gateway. Dokumen ini ditulis untuk tim produk, engineering, dan operasi media yang membutuhkan pemeriksaan berulang sebelum memindahkan job text-to-video dan image-to-video ke produksi.
Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia ini diperiksa pada 15 September 2026 terhadap dokumentasi Google Gemini API, harga Google Gemini API, halaman model Flatkey, dokumentasi quickstart Flatkey, dan direktori model Flatkey. Anggap setiap harga dan status rute sebagai cuplikan publik bertanggal, lalu periksa kembali ketentuan akun Anda sebelum memindahkan traffic produksi.
Jawaban Singkat: Apa yang Harus Diperiksa untuk Akses Veo API
Jika Anda hanya punya waktu untuk satu pengecekan, verifikasi tujuh field berikut sebelum merutekan job produksi:
| Pemeriksaan | Mengapa ini penting | Snapshot yang aman untuk dipublikasikan |
|---|---|---|
| Keluarga model Google langsung | Sekarang Google memisahkan panduan general video generation dari dokumen khusus Veo. | Ikhtisar video Google mengatakan Gemini API menawarkan Gemini Omni Flash dan Veo; ini merekomendasikan Gemini Omni Flash sebagai model video default dan Veo 3.1 saat Anda membutuhkan scene extension, kontrol last-frame, atau alur kerja Veo lama. |
| ID model Veo | Tugas produksi harus mengunci ID model yang persis, bukan hanya "Veo". | Dokumen Veo Google mencantumkan veo-3.1-generate-preview, veo-3.1-fast-generate-preview, dan veo-3.1-lite-generate-preview; halaman model publik Flatkey memverifikasi rute Standard dan Fast, sementara halaman model Flatkey Lite mengembalikan 404 selama refresh ini. |
| Satuan harga | Biaya video bertambah berdasarkan detik, resolusi, klip yang diterima, dan percobaan ulang. | Google mencantumkan harga Veo 3.1 per detik. Halaman model Flatkey menampilkan harga rute per detik untuk Standard dan Fast dengan harga "mulai dari". |
| Model job asinkron | Generasi video adalah alur kerja produksi yang masuk antrean. | Google mendokumentasikan generasi Veo melalui operasi jangka panjang: kirim, polling hingga done, lalu unduh file. |
| Batasan output | Durasi, rasio aspek, resolusi, audio, dan kontrol referensi menentukan apakah fallback valid. | Google mendokumentasikan pilihan durasi 4s, 6s, dan 8s, 16:9 dan 9:16, audio native, opsi 720p/1080p/4k, serta batasan gambar referensi/ekstensi menurut model. |
| Status rute gateway | Sebuah rute gateway hanya berguna jika rute spesifik tersedia dan dapat diamati. | Halaman model Flatkey yang diperiksa untuk Standard dan Fast menunjukkan availability_status: available dan keluarga endpoint termasuk openai-video, gemini, dan openai. |
| Bukti penggunaan | Keuangan dan operasional membutuhkan bukti setelah job selesai. | Dokumentasi quickstart Flatkey menjelaskan penggunaan https://router.flatkey.ai/v1, penyiapan yang kompatibel dengan OpenAI SDK, dan Usage Logs untuk meninjau model, token, latensi, dan biaya. |
Versi singkatnya: jalankan Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia ini sebelum Anda membandingkan kualitas kreatif. Demo prompt bisa terlihat bagus sementara rute produksi masih kekurangan bukti penagihan, perilaku antrean, atau kontrak fallback yang valid.
Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia
Gunakan Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia ini sebagai gerbang peluncuran. Tandai satu baris selesai hanya ketika lingkungan, akun, ID model, rute, dan permukaan penagihan yang tepat telah diperiksa.
| Langkah | Bukti yang diperlukan | Kondisi lolos |
|---|---|---|
| 1. Konfirmasi kelas rute video | API Gemini langsung, rute Flatkey, atau kebijakan multi-penyedia campuran. | Tim tahu apakah klien memanggil Google secara langsung, router Flatkey, atau keduanya. |
| 2. Pilih ID model Veo yang tepat | veo-3.1-generate-preview atau veo-3.1-fast-generate-preview untuk rute Flatkey yang terverifikasi; tim Google langsung juga dapat mengevaluasi Lite. | Tidak ada tugas yang menggunakan alias generik veo dalam konfigurasi produksi. |
| 3. Bekukan kontrak output | Jenis prompt, gambar referensi, rasio aspek, resolusi, durasi, ekspektasi audio native, kebutuhan ekstensi. | Rute fallback dapat mempertahankan janji yang sama yang terlihat oleh pengguna atau pekerjaan tersebut tidak layak untuk fallback. |
| 4. Normalkan harga | Harga per detik, durasi, resolusi, kebijakan retry, tingkat klip yang diterima. | Persetujuan menggunakan estimasi biaya per klip yang diterima, bukan hanya harga mentah per detik. |
| 5. Bangun penanganan asinkron | Tabel job, ID operasi, polling/backoff, timeout, jalur pembatalan, handoff penyimpanan. | Aplikasi dapat bertahan dari job yang berjalan lama dan penyelesaian yang tertunda tanpa kejutan penagihan ganda. |
| 6. Periksa kesehatan rute | Akses provider, status rute Flatkey, request uji, kelas error, envelope latensi. | Smoke test mencatat request ID, model ID, durasi, rute, status penyelesaian, dan biaya. |
| 7. Tetapkan kebijakan fallback | Provider fallback yang diizinkan, perilaku output yang diblokir, anggaran retry, pesan degradasi. | Fallback tidak boleh diam-diam mengubah panjang klip, rasio aspek, atau janji audio. |
| 8. Verifikasi observabilitas | Log, buku besar biaya, rute, jumlah retry, URL aset final, keputusan reviewer. | Produk, engineering, dan finance dapat memeriksa record job yang sama. |
| 9. Periksa ulang sebelum peluncuran | Dokumen Google, harga Google, halaman model Flatkey, halaman harga Flatkey, runbook internal. | Harga dan ketersediaan diberi tanggal dalam catatan rilis. |
Untuk kebijakan rute yang lebih luas, padukan daftar periksa ini dengan panduan routing agen multimodal dari Flatkey. Untuk interpretasi katalog, gunakan panduan katalog model AI sebelum menyetujui satu baris model.
Konfirmasi Apakah Veo Adalah Rute Video Google yang Tepat
Pertanyaan akses pertama bukanlah "Bisakah kita memanggil Veo?" Melainkan "Haruskah workflow ini menggunakan Veo atau model video Google lainnya?" Ikhtisar video Gemini API dari Google menyebutkan bahwa layanan ini menawarkan baik Gemini Omni Flash maupun Veo. Ikhtisar yang sama menempatkan Gemini Omni Flash sebagai model video default dan mengarahkan tim ke Veo 3.1 saat mereka membutuhkan ekstensi adegan, kontrol frame terakhir, atau pipeline Veo yang lebih lama.
Perbedaan ini penting karena akses Veo API sering masuk ke roadmap melalui kebutuhan kreatif: gerakan sinematik yang lebih baik, output resolusi tinggi, audio native, kontrol referensi, atau ekstensi dari adegan yang sudah dihasilkan sebelumnya. Jika pekerjaannya adalah pemahaman video umum atau pekerjaan multimodal yang luas, keputusan rute Anda mungkin berbeda.
Gunakan Veo ketika pekerjaan bergantung pada satu atau beberapa properti berikut:
- Klip pendek yang dihasilkan dengan audio native.
- Output 720p, 1080p, atau 4k jika didukung oleh model dan akun yang dipilih.
- Output
16:9atau9:16dengan durasi yang terkontrol. - Perilaku frame pertama, frame terakhir, atau ekstensi.
- Tata kelola akun Google atau semantik operasi Gemini API langsung.
Gunakan rute gateway ketika tim perlu membandingkan Veo dengan penyedia pembuatan video lainnya, memusatkan pengeluaran, atau mempertahankan proses review rute yang konsisten di seluruh model teks, gambar, audio, dan video. Perbandingan Seedance vs Veo API adalah bacaan internal terdekat ketika keputusannya secara khusus adalah Veo versus Seedance.
Pilih ID Model Veo Saat Ini
Dalam Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia ini, aturan model-ID sederhana: jangan mengonfigurasi "Veo" sebagai label produksi. Konfigurasikan ID model yang tepat dan catat alasan pemilihannya.
| ID Model | Di mana didokumentasikan | Gunakan ini saat | Status rute Flatkey yang diperiksa dalam penyegaran ini |
|---|---|---|---|
veo-3.1-generate-preview | Dokumen dan harga Google Veo; halaman model publik Flatkey. | Anda membutuhkan rute Veo 3.1 standar dan dapat menerima biaya rute yang lebih tinggi. | Halaman publik Flatkey mengembalikan 200 dan menampilkan metadata rute yang tersedia. |
veo-3.1-fast-generate-preview | Dokumen dan harga Google Veo; halaman model publik Flatkey. | Anda menginginkan jalur Veo yang lebih murah dan lebih cepat serta telah menguji kualitas untuk kelas prompt Anda. | Halaman publik Flatkey mengembalikan 200 dan menampilkan metadata rute yang tersedia. |
veo-3.1-lite-generate-preview | Dokumen dan harga Google Veo. | Anda sedang mengevaluasi perilaku Google Lite langsung dan keterbatasannya. | Halaman model Lite publik Flatkey mengembalikan 404 selama penyegaran ini, jadi artikel ini tidak mengklaim adanya rute Flatkey Lite yang aktif. |
Dokumentasi Google menandai keluarga Veo 3.1 sebagai preview. Perlakukan itu sebagai batasan manajemen rilis: daftar periksa produksi Anda harus mencakup pemeriksaan akses bertanggal, hak akses akun, wilayah yang diizinkan jika relevan dengan deployment Anda, perilaku pemblokiran keamanan, pengujian latensi, dan jalur rollback.
Normalisasi Harga Veo API Sebelum Routing
Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia harus membandingkan harga sebagai biaya pekerjaan, bukan sebagai biaya nama model. Mulailah dari durasi dan resolusi yang tepat yang diekspos produk Anda, lalu tambahkan tingkat retry dan tingkat klip yang diterima.
| Rute | Cuplikan harga publik diperiksa 15 September 2026 | Contoh perencanaan 8 detik | Catatan |
|---|---|---|---|
Google langsung veo-3.1-generate-preview | $0.40/sec pada 720p atau 1080p; $0.60/sec pada 4k. | $3.20 pada 720p/1080p; $4.80 pada 4k. | Google mengatakan free tier tidak tersedia untuk Veo 3.1 dan hanya mengenakan biaya jika video berhasil dihasilkan. |
Google langsung veo-3.1-fast-generate-preview | $0.10/sec pada 720p; $0.12/sec pada 1080p; $0.30/sec pada 4k. | $0.80 pada 720p; $0.96 pada 1080p; $2.40 pada 4k. | Kandidat bagus untuk draft atau jalur video Google berbiaya lebih rendah setelah pengujian kualitas. |
Google langsung veo-3.1-lite-generate-preview | $0.05/sec pada 720p; $0.08/sec pada 1080p; 4k tidak didukung. | $0.40 pada 720p; $0.64 pada 1080p. | Harga Google langsung hanya dalam artikel ini; rute Flatkey Lite tidak diverifikasi. |
Flatkey veo-3.1-generate-preview | Halaman model menampilkan harga per detik mulai dari $0.32/sec. | Mulai dari $2.56 untuk 8 detik. | Verifikasi pengaturan rute aktif dan penagihan sebelum peluncuran. |
Flatkey veo-3.1-fast-generate-preview | Halaman model menampilkan harga per detik mulai dari $0.08/sec. | Mulai dari $0.64 untuk 8 detik. | Verifikasi pengaturan rute aktif dan penagihan sebelum peluncuran. |
Kesalahan routing utama adalah menyetujui fallback karena terlihat lebih murah per detik, lalu menemukan bahwa itu mengubah resolusi, perilaku audio, kontrol referensi, atau tingkat klip yang diterima. Jalankan perbandingan akhir sebagai:
accepted_clip_cost:
total_generation_cost: "$ ditagihkan untuk semua percobaan"
accepted_clips: "klip yang lolos QA merek, keselamatan, motion, dan channel"
formula: "total_generation_cost / accepted_clips"Jika suatu rute memiliki biaya mentah yang lebih rendah tetapi menghasilkan lebih banyak klip yang ditolak, biaya produksi sebenarnya bisa lebih tinggi.
Anggap Veo Sebagai Job Video Asinkron
Dokumentasi Veo dari Google menggunakan pola operasi berjalan lama. Klien mengirim permintaan pembuatan, menerima objek operation, melakukan polling sampai operation selesai, lalu mengunduh video yang dihasilkan. Dokumentasi Google juga menyatakan bahwa video yang dihasilkan disimpan selama dua hari dan harus diunduh dalam jendela waktu tersebut.
Artinya, akses API Veo membutuhkan sistem job, bukan hanya pembungkus request. Klien Anda harus mencatat:
- ID job internal.
- ID operasi provider atau ID request gateway.
- ID model.
- Jenis input dan aset referensi.
- Durasi, resolusi, dan rasio aspek.
- Waktu mulai, jumlah polling, waktu selesai, status timeout.
- Pemblokiran keselamatan, error provider, jumlah retry, dan rute fallback jika digunakan.
- Lokasi aset akhir dan kebijakan retensi/penghapusan.
- Jumlah tagihan akhir dan tautan log penggunaan.
Bagi pengguna Flatkey, quickstart API Flatkey adalah langkah berikutnya untuk penyiapan base URL. Quickstart tersebut mendokumentasikan https://router.flatkey.ai/v1 dan konfigurasi yang kompatibel dengan OpenAI SDK; untuk video produksi, gunakan disiplin yang sama tetapi lakukan smoke test pada endpoint video spesifik dan route model yang ingin Anda gunakan.
Verifikasi Status Route Flatkey dan Keluarga Endpoint
Verifikasi route Flatkey sebaiknya dilakukan di halaman model dan di log akun Anda sendiri.
Untuk refresh ini, halaman model publik Flatkey mengembalikan 200 untuk:
https://flatkey.ai/models/veo-3.1-generate-previewhttps://flatkey.ai/models/veo-3.1-fast-generate-preview
Halaman-halaman tersebut menampilkan Google sebagai vendor, availability_status: available, harga per detik, dan keluarga endpoint termasuk openai-video, gemini, dan openai. Halaman publik untuk veo-3.1-lite-generate-preview mengembalikan 404, jadi klaim yang aman terbatas: Google mendokumentasikan Lite secara langsung, tetapi refresh ini tidak memverifikasi route Lite Flatkey.
Sebelum produksi, ambil tangkapan layar atau ekspor baris model, lalu jalankan smoke test kecil dan pastikan hasilnya muncul di Usage Logs. direktori model dan halaman harga Flatkey harus menjadi bagian dari checklist rilis bertanggal.
Tetapkan Aturan Fallback di Seluruh Penyedia Video
Fallback lebih sulit untuk video daripada teks. Fallback model teks mungkin mempertahankan maksud dengan gaya yang berbeda. Fallback model video dapat mengubah durasi klip, perilaku kamera, kepatuhan terhadap referensi, audio, resolusi, biaya, dan hasil moderasi.
Gunakan matriks fallback ini sebelum mengaktifkan retry otomatis:
| Jenis kegagalan | Retry route yang sama? | Fallback diizinkan? | Catatan operator |
|---|---|---|---|
| Kesalahan route sementara | Ya, dalam batas retry yang ditetapkan. | Ya, jika kontrak output setara. | Pertahankan idempotensi agar retry tidak menciptakan biaya ganda bagi pengguna. |
| Blokir keamanan atau kebijakan | Tidak ada retry otomatis tanpa input yang diubah. | Biasanya tidak. | Minta revisi prompt/reference alih-alih diam-diam mengubah provider. |
| Batas latensi terlewati | Mungkin, jika pekerjaan tidak terlihat oleh pengguna. | Ya, untuk lane draft. | Tampilkan status progres dan hindari retry tersembunyi yang berulang. |
| Batas anggaran tercapai | Tidak. | Tidak, kecuali route yang lebih murah sudah disetujui sebelumnya. | Batas anggaran harus menghentikan pekerjaan, bukan menyembunyikan pengeluaran. |
| Fitur tidak didukung | Tidak. | Hanya jika fallback mendukung fitur yang diperlukan. | Jangan fallback dari kebutuhan native audio ke video tanpa suara tanpa keputusan produk. |
Untuk tim video multi-penyedia, kuncinya adalah melakukan routing berdasarkan kelas alur kerja:
- Klip Google dengan native audio.
- Klip draft Veo dengan biaya lebih rendah.
- Klip kreator dengan banyak referensi.
- Pekerjaan video sosial yang lebih panjang.
- Pekerjaan ekspor beresolusi tinggi.
- Pekerjaan tinjau manual, di mana output yang diblokir harus dikembalikan ke editor.
Di situlah gateway terpadu membantu: gateway memberi engineering satu tempat untuk merutekan, product satu tempat untuk mendefinisikan kebijakan model, dan finance satu buku besar untuk ditinjau. Ini tidak menghilangkan kebutuhan untuk memverifikasi perilaku output yang tepat dari setiap rute.
Jalankan Smoke Test Peluncuran
Jalankan smoke test Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia ini di staging sebelum membuka akses Veo API ke traffic kreator:
- Buat tiga job representatif: klip landscape hanya prompt, klip portrait dengan referensi gambar, dan klip dengan audio native.
- Jalankan setiap job pada rute Veo yang dipilih dengan durasi dan resolusi yang persis sama seperti yang direncanakan untuk produksi.
- Catat operation ID, request ID, model ID, route, waktu mulai, waktu selesai, dan URL output.
- Verifikasi bahwa job muncul di Flatkey Usage Logs atau catatan penggunaan Google langsung.
- Pastikan total biaya sesuai dengan unit per detik, durasi, dan resolusi yang diharapkan.
- Paksa satu kegagalan yang dapat dicoba ulang dan pastikan idempotency mencegah duplikasi catatan final.
- Paksa satu job yang diblokir atau ditolak dan pastikan UI meminta input revisi, alih-alih melakukan fallback secara diam-diam.
- Pastikan aset yang dihasilkan diunduh dan disimpan sebelum jendela retensi penyedia berakhir.
- Tinjau bukti final bersama product, engineering, dan finance sebelum peluncuran.
Catatan Akses Veo yang Dapat Disalin
Gunakan catatan Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia ini di daftar periksa rilis atau repositori routing Anda:
veo_access_record:
checked_at: "YYYY-MM-DD"
owner: "team or person"
route_mode: "direct_google | flatkey | mixed"
model_id: "veo-3.1-fast-generate-preview"
provider_docs_checked:
- "Google Gemini API video overview"
- "Google Gemini API Veo docs"
- "Google Gemini API pricing"
flatkey_checks:
model_page_status: "200"
availability_status: "available"
endpoint_family: "openai-video"
usage_logs_verified: true
output_contract:
duration_seconds: 8
aspect_ratio: "16:9"
resolution: "720p"
native_audio_required: true
reference_images_required: 0
cost_review:
billing_unit: "per_second"
displayed_unit_price: "record current account/page value"
retry_budget: "max attempts"
accepted_clip_cost_target: "USD"
async_handling:
operation_id_saved: true
polling_backoff: "configured"
timeout_policy: "configured"
asset_download_window: "before provider expiry"
fallback_policy:
enabled: false
allowed_routes: []
contract_preserved: true
rollback:
owner: "team or person"
trigger: "error rate, cost, latency, quality, safety"
action: "disable route or switch workflow class"Pertanyaan Umum
Bagaimana Cara Mendapatkan Akses Veo API?
Mulailah dengan dokumentasi Gemini API Google dan akses akun Google Anda, lalu tentukan apakah rute harus berjalan langsung melalui Google atau melalui gateway seperti Flatkey. Gunakan Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia untuk memverifikasi halaman model yang aktif dan menjalankan permintaan bertahap sebelum traffic produksi.
Model ID Veo Mana yang Harus Saya Gunakan?
Gunakan veo-3.1-generate-preview saat Anda memerlukan jalur Veo 3.1 standar. Gunakan veo-3.1-fast-generate-preview saat kualitas Fast sesuai dengan alur kerja Anda dan rute dengan biaya per detik yang lebih rendah tepat digunakan. Evaluasi veo-3.1-lite-generate-preview hanya terhadap dokumen Google langsung, kecuali akun Flatkey Anda atau halaman model mengonfirmasi rute Lite yang aktif.
Bagaimana Harga Veo API Dihitung?
Google mencantumkan harga Veo 3.1 per detik yang dihasilkan, dengan tarif berbeda حسب model dan resolusi. Halaman model Flatkey juga menampilkan harga rute per detik untuk halaman Veo Standard dan Fast yang terverifikasi. Tinjauan produksi Anda harus mengalikan harga unit dengan durasi, resolusi, percobaan ulang, dan tingkat klip yang diterima.
Apakah Veo Dapat Dirutekan Bersama Model Generasi Video Lain?
Ya, tetapi fallback harus mempertahankan kontrak keluaran yang terlihat oleh pengguna. Jangan secara otomatis melakukan fallback dari pekerjaan Veo native-audio, 8 detik, 1080p ke pekerjaan tanpa suara, lebih pendek, dan beresolusi lebih rendah kecuali produk secara eksplisit mengizinkan penurunan tersebut.
Apa yang Harus Diverifikasi Pengguna Flatkey Sebelum Produksi?
Periksa halaman model Flatkey, direktori model, halaman harga, kesehatan rute, dan Usage Logs. Lalu jalankan smoke test khusus video, alih-alih berasumsi bahwa quickstart teks yang kompatibel dengan OpenAI membuktikan perilaku video.
Kesimpulan Akhir
Daftar Periksa Akses Veo API untuk Routing Video Multi-Penyedia harus diakhiri dengan bukti bertanggal, bukan preferensi. Bekukan model ID, normalkan harga per klip yang diterima, rancang untuk pekerjaan asinkron, verifikasi rute Flatkey atau akun Google langsung, dan setujui fallback hanya jika itu mempertahankan kontrak keluaran. Lalu gunakan direktori model Flatkey, halaman harga, quickstart, dan usage logs untuk menjaga rute produksi tetap dapat diaudit setelah peluncuran.
