Sora API — yapay zeka ile video üretimi (bugün Veo 3.1 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 %50-70 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