Sora API — yapay zeka ile video üretimi (bugün Veo 3 ile)

Sora, OpenAI'nin metinden videoya modelidir ve “Sora API”, ekiplerin tüketici uygulaması yerine videoyu programlı olarak ürettiği yoldur. Kunavo'da bugün metinden videoya dönüştürme Google Veo 3 ile tek bir OpenAI tarzı video uç noktası üzerinden çalışır — Sora erişimi yol haritasındadır ve uç nokta modelden bağımsız olduğundan ileride Sora'ya geçiş tek kelimelik bir değişikliktir. Bu rehber, her örnek hemen şimdi çalışsın diye iş akışını Veo 3 ile gösterir.

Sora API nedir?

Sora (Sora 2 ve Sora 2 Pro), bir metin istemini — ya da sabit bir görseli — kısa bir video klibe dönüştürür; Sora 2'de senkronize sesle birlikte. API biçimi, üretimi bir hatta yazmanıza olanak tanır: pazarlama çekimleri, ürün animasyonları, b-roll, taslak önizlemeleri. Biçim modern video modellerinde aynıdır: bir istem ve parametreler 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 üzerinden sunar: /v1/video/generations. Sora henüz katalogda etkin değil; canlı metinden videoya modeli, yerel sesle sinematik klipler üreten Google Veo 3'tür. Aşağıdaki örnekler veo-3 kullanır — Sora geldiğinde değişen tek şey model alanıdır.

Metinden videoya hızlı başlangıç

Kunavo anahtarınızla tek bir POST. Üretim birkaç dakika sürebilir; bu yüzden senkron çağrı, klip hazır olana kadar bağlantıyı tutar:

import requests

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "kırmızı bir origami turnanın açılışına yumuşak ışıkta sinematik dolly-in",
        "duration": 5,
        "aspect_ratio": "16:9",
    },
    timeout=600,  # üretim dakikalar sürebilir
)
print(resp.json()["data"][0]["url"])

Görselden videoya

Sabit bir görseli hareketlendirmek için istemle birlikte image_url (bir https URL'si veya /v1/files adresine yüklediğiniz bir dosya) geçirin. Kontrollü hareket için image_urls ve image_mode: "frame" ile ilk ve son kareyi geçebilirsiniz. Tam örnekler video dokümanlarında.

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

Üretimde 10 dakikalık bir bağlantıyı tutmayın. /v1/videos adresine bir görev gönderin, hemen bir görev kimliği alın, sonra tamamlanana kadar GET /v1/videos/{id} adresini yoklayın. Sonuç URL'leri kalıcıdır.

# Üretim: bir görev gönderin, sonra yoklayın — uzun ömürlü bağlantı yok.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # ~24s içinde yeniden denemeye güvenli
    },
    json={"model": "veo-3", "prompt": "...", "duration": 5, "aspect_ratio": "16:9"},
    timeout=60,
).json()
# ardından tamamlanana kadar GET /v1/videos/{task["id"]} adresini yoklayın

Video dokümanları, tam yoklama döngüsünü, idempotency anahtarlarını ve webhook teslimatını kapsar.

Fiyatlandırma

Veo 3, video başına faturalandırılır (burada 720p'de 8 saniyelik klip başına gösterilmiştir) ve Google'ın liste fiyatının yaklaşık %40-60 altındadır. Daha yüksek çözünürlükler daha pahalıdır — tam katman tablosu için fiyatlandırma sayfasına bakın.

Video için istem ipuçları

• Sadece özneyi değil, çekimi tanımlayın. Kamera hareketi (dolly, pan, push-in), lens hissi, ışık ve tempo, sıfatlardan daha çok önem taşır.
• En-boy oranını açıkça belirleyin — yatay için 16:9, dikey/sosyal için 9:16.
• Klipleri kısa tutun. 5-8 saniye en ideal aralıktır; daha uzun diziler için birden çok üretimi birbirine ekleyin.
• Bir referans kare kullanın (görselden videoya) — belirli bir karakterin veya ürünün tutarlı kalması gerektiğinde.

SSS

Sora API'yi Kunavo'da bugün kullanabilir miyim?

Henüz değil — Sora katalogda etkin değil. Metinden videoya dönüştürme bugün aynı OpenAI tarzı uç nokta üzerinden Veo 3 ile çalışır ve ileride Sora'ya geçiş tek kelimelik bir model değişikliğidir. Sora erişimi yol haritasındadır.

Video üretimi ne kadar?

Veo 3 video başınadır, Google'ın listesinin yaklaşık %40-60 altında: 8s 720p klip başına Lite $0.16'dan, Fast $0.32'den, Quality $1.92'den.

Kunavo görselden videoya dönüştürmeyi destekliyor mu?

Evet — /v1/video/generations adresine image_url ya da kontrollü geçişler için bir ilk/son kare çifti geçirin.

Üretim ne kadar sürer?

Dakikalar. Üretimde asenkron /v1/videos görev API'sini kullanın ve yoklayın; bkz. video dokümanları.