API Veo 3.1 — text-to-video Google dengan audio native, kompatibel dengan OpenAI (2026)

Veo 3 adalah model teks-ke-video milik Google, dan API Veo 3 menghasilkan klip sinematik — dengan audio bawaan yang tersinkronisasi — dari prompt teks atau gambar diam. Kunavo menyediakan seluruh keluarga ini (veo-3-lite, veo-3 Fast, dan veo-3-quality) melalui endpoint video bergaya OpenAI, dengan harga sekitar 50–70% di bawah harga resmi Google, menggunakan satu token bearer.

Panggil API Veo 3

Buat kunci di /app/keys dan lakukan POST ke /v1/video/generations. Generasi memerlukan beberapa menit, sehingga panggilan sinkron menahan koneksi sampai klip siap:

import requests

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",                 # Fast tier; also veo-3-lite / veo-3-quality
        "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
        "aspect_ratio": "16:9",
        "resolution": "720p",
    },
    timeout=600,  # Veo 3 generation takes minutes
)
print(resp.json()["data"][0]["url"])

Panggilan yang sama dengan curl:

curl https://api.kunavo.com/v1/video/generations \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{
    "model": "veo-3",
    "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

Jika codebase Anda sudah berjalan dengan OpenAI SDK, Anda dapat mempertahankan satu klien untuk semuanya — chat, gambar, dan video berbagi kunci dan base_url:

# Already using the OpenAI SDK? Keep it — only base_url changes.
# Video isn't in the OpenAI SDK surface, so reuse its client for auth/config
# and post to the video route directly.
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",
)

resp = client.post(
    "/video/generations",
    body={"model": "veo-3", "prompt": "a neon-lit alley in the rain"},
    cast_to=object,
    options={"timeout": 600.0},
)
print(resp["data"][0]["url"])

duration (dalam detik) menentukan durasi klip pada model dengan penagihan per detik: model-model Seedance dan model Wan 2.7. Model-model Veo mengabaikannya; setiap klip Veo berdurasi 8 detik dan ditagih per video.

URL yang dikembalikan bersifat permanen. Parameter lengkap (resolution, aspect_ratio, image_urls, image_mode) tersedia dalam referensi API video.

Di Kunavo, Veo tidak memiliki parameter seed maupun parameter prompt negatif. Jika sebuah permintaan mengirimkan salah satunya, parameter itu diabaikan.

Tingkatan dan harga

Veo 3 memiliki tiga tingkatan kualitas. Tarif per video di bawah ini berlaku untuk klip 720p berdurasi 8 detik; 1080p dan 4K lebih mahal. Tarif langsung tersedia di halaman setiap model.

Gambar menjadi video

Kirim image_url untuk menganimasikan gambar diam — berguna untuk menjaga konsistensi produk atau karakter. Kirim frame pertama dan terakhir untuk transisi yang terkontrol.

# Image-to-video: animate a still by passing image_url
requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "slow parallax, gentle wind through the grass",
        "image_url": "https://your-cdn.com/keyframe.png",
    },
    timeout=600,
)

Asinkron dalam produksi

Jangan menahan koneksi selama beberapa menit pada skala besar. Kirim tugas ke /v1/videos, dapatkan ID tugas, lalu polling GET /v1/videos/{id} sampai selesai — dengan kunci idempotensi dan webhook opsional. Alur lengkapnya ada di dokumentasi video.

Membuat prompt untuk Veo 3

• Deskripsikan adegannya, bukan hanya subjeknya — pergerakan kamera (dolly, pan, push-in), nuansa lensa, pencahayaan, dan tempo paling berpengaruh.
• Manfaatkan audio — Veo 3 merender suara, jadi sebutkan suasana atau efek yang diinginkan.
• Tetapkan rasio aspek secara eksplisit — 16:9 untuk lanskap, 9:16 untuk vertikal/sosial.
• Setiap klip Veo berdurasi 8 detik — rancang setiap adegan untuk durasi itu, dan gabungkan beberapa hasil untuk urutan yang lebih panjang.

Kunavo dibandingkan pemanggilan Google secara langsung

Veo 3 juga tersedia langsung melalui Gemini API dan Vertex AI. Jalur tersebut tepat jika Anda memerlukan SLA dan kontrak dukungan milik Google. Berikut pertukaran yang sebenarnya:

Versi singkat: Kunavo unggul dalam waktu penyiapan, harga per unit, dan satu kunci untuk semua modalitas. Google langsung unggul ketika Anda memerlukan jaminan kuota atau perjanjian perusahaan.

Veo 3 dibandingkan Sora dan Kling

Veo 3 adalah model teks-ke-video yang paling kuat dan tersedia secara umum saat ini, serta model live di Kunavo. Sora dan Kling ada di roadmap di balik endpoint yang sama — lihat panduan API teks-ke-video untuk gambaran model, serta panduan API Sora dan API Kling untuk keluarga tersebut.

Memilih model video berdasarkan harga, bukan hanya keluarga ini? Perbandingan API generasi video memberi harga untuk kedelapan model berdasarkan klip 720p berdurasi 8 detik yang sama.

Pertanyaan umum