Sora API — OpenAI uyumlu iş akışında text-to-video

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

Sora API nedir?

Sora (Sora 2 ve Sora 2 Pro), bir metin istemini veya sabit bir görüntüyü, Sora 2'de senkronize ses içeren kısa bir video klibine dönüştürür. API biçimi, üretimi bir işlem hattına komut dosyasıyla eklemenizi sağlar: pazarlama çekimleri, ürün animasyonları, b-roll, storyboard önizlemeleri. Modern video modellerinde yapı aynıdır: bir istem ve parametreler gönderir, barındırılan bir video URL'si alırsınız.

Bugün Kunavo'da video: Veo 3

Kunavo, video üretimini tek bir OpenAI tarzı uç nokta olan /v1/video/generations üzerinden sunar. Sora henüz katalogda etkinleştirilmemiştir; kullanıma açık 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ında olur.

Metinden videoya hızlı başlangıç

Kunavo anahtarınızla tek bir POST isteği. Üretim birkaç dakika sürebileceğinden, 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",
        "prompt": "a cinematic dolly-in on a red origami crane unfolding, soft light",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # generation can take minutes
)
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

Sabit bir görüntüyü canlandırmak için istemle birlikte image_url parametresini gönderin (bir https URL'si veya /v1/files uç noktasına yüklediğiniz bir dosya). Kontrollü hareket için image_urls ve image_mode: "frame" ile ilk ve son kareyi gönderebilirsiniz. Tam örnekler video belgelerinde bulunur.

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

Üretimde 10 dakikalık bir bağlantıyı açık tutmayın. /v1/videos uç noktasına görev gönderin, hemen bir görev kimliği alın, ardından tamamlanana kadar GET /v1/videos/{id} çağrısıyla durumu sorgulayın. Sonuç URL'leri kalıcıdır.

# Production: submit a task, then poll — no long-lived connection.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # retry-safe within ~24h
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# then poll GET /v1/videos/{task["id"]} until it completes

Video belgeleri, tam sorgulama döngüsünü, idempotency anahtarlarını ve webhook teslimini kapsar.

Fiyatlandırma

Veo 3 video başına (burada gösterilen 720p, 8 saniyelik klip başına), Google'ın liste fiyatından yaklaşık50–70% daha düşük ücretlendirilir. Daha yüksek çözünürlükler daha pahalıdır — tam kademe tablosu için fiyatlandırma sayfasına bakın.

Video için istem yazma ipuçları

• Yalnızca özneyi değil, çekimi betimleyin. Kamera hareketi (dolly, pan, push-in), lens hissi, ışıklandırma ve tempo sıfatlardan daha önemlidir.
• 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 ç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ı gerektiğinde referans karesi (görüntüden videoya) kullanın.

Sık sorulan sorular