Sora API — OpenAI benzeri uç noktada yapay zeka videosu oluşturma (bugün Veo 3.1 ile)

Sora, OpenAI'ın metinden videoya modelidir ve “Sora API”, ekiplerin tüketici uygulaması yerine programatik olarak video üretmesini sağlayan yoldur. Kunavo'da metinden videoya üretim bugün, OpenAI tarzı bir video uç noktasında Google Veo 3 üzerinden çalışır — Sora erişimi yol haritasındadır ve uç nokta modelden bağımsız olduğu için daha sonra Sora'ya geçiş tek kelimelik bir değişikliktir. Bu kılavuz, her örneğin hemen çalışabilmesi için Veo 3 ile iş akışını gösterir.

Sora API nedir?

Sora (Sora 2 ve Sora 2 Pro), bir metin istemini — veya sabit bir görüntüyü — kısa bir video klibine dönüştürür; Sora 2'de senkronize ses bulunur. API biçimi, üretimi bir işlem hattına betiklemenizi sağlar: pazarlama çekimleri, ürün animasyonları, B-roll ve storyboard önizlemeleri. Biçim, modern video modellerinde aynıdır: istemi ve parametreleri gönderin, barındırılan bir video URL'si alın.

Kunavo'da bugün video: Veo 3

Kunavo, video üretimini tek bir OpenAI tarzı uç nokta olan /v1/video/generations üzerinden sunar. Sora henüz katalogda etkinleştirilmedi; etkin metinden videoya modeli, yerleşik sesli sinematik klipler üreten Google Veo 3'tür. Aşağıdaki örneklerde veo-3 kullanılır — Sora geldiğinde tek değişiklik model alanı olacaktır.

Metinden videoya hızlı başlangıç

Kunavo anahtarınızla bir POST isteği gönderin. Üretim birkaç dakika sürebileceğinden, eşzamanlı çağrı klip tamamlanana 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",
        "prompt": "a cinematic dolly-in on a red origami crane unfolding, soft light",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # die Generierung kann Minuten dauern
)
print(resp.json()["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.

Görüntüden videoya

Bir sabit görüntüyü canlandırmak için istemle birlikte image_url parametresini (bir https URL'si veya /v1/files uç noktasına yüklediğiniz bir dosya) gönderin. Kontrollü hareket için image_urls ve image_mode: "frame" ile başlangıç ve bitiş karesi sağlayabilirsiniz. Tam örnekler Video belgelerinde bulunur.

Asenkron görev yaşam döngüsü

Üretimde 10 dakikalık bir bağlantıyı açık tutmamalısınız. /v1/videos uç noktasına bir görev gönderin, hemen bir görev kimliği alın ve görev tamamlanana kadar GET /v1/videos/{id} isteğiyle düzenli olarak durumunu sorgulayın. Sonuç URL'leri kalıcıdır.

# Produktion: Task einreichen, dann pollen — keine langlebige Verbindung.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # innerhalb von ~24h retry-sicher
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# dann GET /v1/videos/{task["id"]} pollen, bis er fertig ist

Video belgeleri, yoklama döngüsünün tamamını, idempotency anahtarlarını ve webhook teslimini ele alır.

Fiyatlar

Veo 3 video başına ücretlendirilir (burada 720p'de 8 saniyelik klip başına) ve Google'ın liste fiyatından yaklaşık 50–70% daha ucuzdur. Daha yüksek çözünürlükler daha pahalıdır — tam kademe tablosu fiyatlandırma sayfasında yer alır.

Video için istem yazma ipuçları

• Yalnızca konuyu değil, sahneyi de açıklayın. Kamera hareketi (dolly, pan, push-in), lens görünümü, aydınlatma ve tempo; sıfatlardan daha önemlidir.
• En-boy oranını açıkça belirleyin — yatay format için 16:9, dikey format/sosyal medya için 9:16.
• Her Veo klibi 8 saniyedir. Her çekimi bu süreye göre planlayın ve daha uzun sekanslar için birden fazla üretimi birleştirin.
• Belirli bir karakterin veya ürünün tutarlı kalması gerekiyorsa referans karesi (görüntüden videoya) kullanın.

Sık sorulan sorular