Sora API nasıl kullanılır — hemen çalışan yapay zekâ video oluşturma (Veo 3.1 / OpenAI uyumlu)

Sora, OpenAI'nin metinden video üreten modelidir ve “Sora API”, tüketici uygulaması yerine program aracılığıyla video üretme yöntemidir. Kunavo'da metinden videoya üretim şu anda Google Veo 3 ile tek bir OpenAI tarzı video uç noktası üzerinden çalışır — Sora desteği yol haritasındadır ve uç nokta modelden bağımsız olduğundan daha sonra Sora'ya geçmek yalnızca tek kelimelik bir değişikliktir. Bu rehberdeki tüm örneklerin hemen çalışabilmesi için iş akışı Veo 3 ile gösterilir.

Sora API nedir?

Sora (Sora 2 ve Sora 2 Pro), metin istemini — veya tek bir sabit görüntüyü — kısa video kliplerine dönüştürür; Sora 2'de senkronize ses de eklenir. API biçiminde kullanıldığında üretimi bir işlem hattına entegre edebilirsiniz: pazarlama videoları, ürün animasyonları, b-roll ve storyboard önizlemeleri gibi içerikler için. Biçim, son dönem video modellerinin genelinde ortaktır: istem ve parametreleri gönderir, barındırılan bir video URL'si alırsınız.

Kunavo'da şu anda kullanılabilen 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; şu anda kullanılabilen metinden videoya model, yerleşik sesli sinematik klipler üreten Google Veo 3'tür. Aşağıdaki örneklerde veo-3 kullanılır — Sora geldiğinde yalnızca model alanını değiştirmeniz gerekir.

Metinden videoya hızlı başlangıç

Kunavo anahtarınızla tek bir POST isteği yeterlidir. Ü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,  # 生成には数分かかることがあります
)
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 (https URL'si veya /v1/files uç noktasına yüklediğiniz dosya) gönderin. Hareketi kontrol etmek istiyorsanız ilk ve son kareleri image_urls ve image_mode: "frame" ile gönderebilirsiniz. Ayrıntılı örnekler video belgelerinde bulunur.

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

Üretimde 10 dakika boyunca bağlantıyı açık tutmayın. /v1/videos adresine görev gönderdiğinizde hemen bir görev kimliği döner; tamamlanana kadar GET /v1/videos/{id} ile yoklayın. Sonuç URL'si kalıcıdır.

# 本番: タスクを投入してからポーリング——長時間の接続を保持しません。
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Idempotency-Key": "my-task-uuid",   # 約 24 時間はリトライしても安全
    },
    json={"model": "veo-3", "prompt": "...", "aspect_ratio": "16:9"},
    timeout=60,
).json()
# その後 GET /v1/videos/{task["id"]} を完了までポーリングします

Video belgeleri, yoklama döngüsünün tamamını, idempotency anahtarlarını ve webhook teslimini açıklar.

Ücretler

Veo 3 video başına ücretlendirilir (burada 720p, 8 saniyelik klip başına) ve Google's liste fiyatından yaklaşık 50–70% daha ucuzdur. Çözünürlük yükseldikçe maliyet de artar — tam seviye tablosu için fiyatlandırma sayfasına bakın.

Video istemleri için ipuçları

• Yalnızca özneyi değil, çekimi de betimleyin. Kamera hareketi (dolly, pan, push-in), lens görünümü, ışıklandırma ve tempo; sıfatlardan daha etkilidir.
• En-boy oranını açıkça belirtin — yatay için 16:9, dikey/SNS 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.
• Referans kareleri kullanın (görüntüden videoya) — belirli bir karakteri veya ürünü tutarlı kılmak istediğinizde etkilidir.

Sık sorulan sorular