Sora API — OpenAI uyumlu bir iş akışında metinden video

Sora, OpenAI'nin metinden videoya modelidir ve “Sora API”, ekiplerin tüketici uygulaması yerine programatik olarak video üretme biçimini ifade eder. 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çiş tek kelimelik bir değişikliktir. Bu kılavuz, her örneğin şu anda çalışabilmesi için Veo 3 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ı içinde senaryolaştırmanıza olanak tanır: pazarlama çekimleri, ürün animasyonları, b-roll ve storyboard önizlemeleri. Biçim, modern video modelleri arasında aynıdır: bir istem ve parametreler gönderir, barındırılan bir videonun URL'sini geri 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 etkin değildir; 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ı olacaktır.

Metinden videoya hızlı başlangıç

Kunavo anahtarınızla bir POST isteği. Üretim birkaç dakika sürebileceğinden, senkron ç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": "um dolly-in cinematográfico em um origami de garça vermelha se abrindo, luz suave",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # a geração pode levar minutos
)
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 (bir https URL'si veya /v1/files adresine yüklenmiş bir dosya) gönderin. Kontrollü hareket için image_urls ve image_mode: "frame" ile bir ilk ve son kare gönderebilirsiniz. Tam örnekler video belgelerinde yer alır.

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

Üretimde 10 dakikalık bir bağlantıyı açık tutmayın. /v1/videos adresine bir görev gönderin, hemen bir görev kimliği alın ve ardından tamamlanana kadar GET /v1/videos/{id} üzerinde polling yapın. Sonuç URL'leri kalıcıdır.

# Produção: envie uma tarefa e faça polling — sem conexão de longa duração.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "meu-uuid-de-tarefa",   # seguro para retry em ~24h
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# depois faça polling em GET /v1/videos/{task["id"]} até concluir

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

Fiyatlar

Veo 3 video başına ücretlendirilir (burada gösterildiği gibi 720p'de 8 saniyelik klip başına); Google'ın liste fiyatından yaklaşık 50–70% daha düşüktür. Daha yüksek çözünürlükler daha pahalıdır — aralıkların tamamı için fiyatlandırma sayfasına bakın.

Video istemi ipuçları

• Sadece özneyi değil, çekimi betimleyin. Kamera hareketi (dolly, pan, push-in), lens hissi, aydınlatma ve tempo; sıfatlardan daha önemlidir.
• En-boy oranını açıkça belirtin — 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 bir referans karesi (görüntüden videoya) kullanın.

Sık sorulan sorular