Veo 3.1 API — Google'ın yerleşik sesli, OpenAI uyumlu metinden videoya modeli (2026)

Veo 3, Google'ın metinden videoya modelidir; Veo 3 API ise bir metin isteminden veya sabit görüntüden yerleşik ve senkronize ses içeren sinematik klipler oluşturur. Kunavo, tüm aileyi (veo-3-lite, veo-3 Fast ve veo-3-quality) OpenAI tarzı video uç noktası üzerinden, Google liste fiyatından yaklaşık %50–70 daha düşük fiyatla ve tek bir bearer token ile sunar.

Veo 3 API'sini çağırın

/app/keys sayfasında bir anahtar oluşturun ve /v1/video/generations uç noktasına POST isteği gönderin. Oluşturma birkaç dakika sürdüğünden eşzamanlı çağrı, klip hazır olana kadar bağlantıyı açık tutar:

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"])

Aynı çağrının curl ile kullanımı:

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"
  }'

Kod tabanınızın geri kalanı zaten OpenAI SDK ile çalışıyorsa her şey için tek istemci kullanmaya devam edebilirsiniz — sohbet, görüntüler ve video aynı anahtarı ve aynı base_url değerini kullanır:

# 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 (saniye cinsinden), saniye başına ücretlendirilen modellerde, yani Seedance modellerinde ve Wan 2.7'de klip uzunluğunu belirler. Veo modelleri bu değeri yok sayar; her Veo klibi 8 saniyedir ve video başına ücretlendirilir.

Döndürülen URL'ler kalıcıdır. Tüm parametreler (resolution, aspect_ratio, image_urls, image_mode) video API referansında bulunur.

Kunavo'da Veo'nun seed parametresi de negatif istem parametresi de yoktur. Bir istek bunlardan birini gönderirse o parametre yok sayılır.

Kademeler ve fiyatlandırma

Veo 3'ün üç kalite kademesi vardır. Aşağıdaki video başına ücretler 8 saniyelik 720p klip içindir; 1080p ve 4K daha üst fiyat kademelerine çıkar. Canlı ücretler her model sayfasında yer alır.

Görüntüden videoya

Bir sabit görüntüyü canlandırmak için image_url parametresini gönderin — ürün veya karakter tutarlılığını korumak için kullanışlıdır. Kontrollü geçişler için ilk ve son kareyi gönderin.

# 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,
)

Üretimde eşzamansız kullanım

Ölçekte birkaç dakikalık bağlantıyı açık tutmayın. /v1/videos uç noktasına bir görev gönderin, görev kimliği alın ve tamamlanana kadar GET /v1/videos/{id} isteğiyle durumu yoklayın — idempotency anahtarları ve isteğe bağlı webhook'larla. Tüm döngü video belgelerinde yer alır.

Veo 3 için istem yazma

• Yalnızca özneyi değil, sahneyi tarif edin — kamera hareketi (dolly, pan, push-in), lens hissi, ışıklandırma ve tempo en önemlisidir.
• Ses özelliklerinden yararlanın — Veo 3 ses oluşturur; bu nedenle istediğiniz ortam sesini veya efektleri belirtin.
• En-boy oranını açıkça ayarlayın — manzara için 16:9, dikey/sosyal medya için 9:16.
• Her Veo klibi 8 saniyedir — her sahneyi bu süreye göre planlayın; daha uzun sekanslar için oluşturulan klipleri birleştirin.

Kunavo ve Google'ı doğrudan çağırmak

Veo 3, Gemini API ve Vertex AI üzerinden birinci taraf olarak da kullanılabilir. Google'ın kendi SLA'sına ve destek sözleşmesine ihtiyacınız varsa doğru yol budur. Dürüst karşılaştırma şöyle:

Kısaca: Kunavo kurulum süresi, birim fiyat ve her modalite için tek anahtar kullanımı açısından avantajlıdır. Google doğrudan ise kota garantisi veya kurumsal sözleşme gerektiğinde avantajlıdır.

Veo 3 ve Sora ile Kling karşılaştırması

Veo 3 bugün genel kullanıma açık en güçlü metinden videoya modelidir ve Kunavo'daki canlı modeldir. Sora ve Kling aynı uç noktanın arkasında yol haritasındadır — model görünümü için metinden videoya API kılavuzuna, bu aileler için Sora API ve Kling API kılavuzlarına bakın.

Bu aile yerine video modelleri arasında fiyat temelinde mi seçim yapıyorsunuz? Video oluşturma API karşılaştırması, sekiz modelin tamamını aynı 8 saniyelik 720p klibe göre fiyatlandırır.

Sık sorulan sorular