Sora API rehberi — hemen kullanılabilen yapay zekâ video oluşturma (Veo 3.1)

Sora, OpenAI'nin text-to-video modelidir ve “Sora API”, tüketici uygulaması yerine programatik olarak video oluşturma yöntemidir. Kunavo'da text-to-video şu anda tek bir OpenAI tarzı video uç noktası üzerinden Google Veo 3 ile çalışır — Sora desteği yol haritasındadır ve uç nokta modele bağlı olmadığından, daha sonra Sora'ya geçmek yalnızca tek bir kelimeyi değiştirmeyi gerektirir. Bu kılavuz, tüm örneklerin hemen çalışması için iş akışını Veo 3 ile gösterir.

Sora API nedir?

Sora (Sora 2 ve Sora 2 Pro), metin istemlerini veya sabit görüntüleri kısa video kliplerine dönüştürür ve Sora 2'de senkronize ses de sağlar. API biçiminde oluşturma işlemini bir işlem hattına komut dosyasıyla ekleyebilirsiniz: pazarlama görüntüleri, ürün animasyonları, b-roll, storyboard önizlemeleri. Güncel video modellerinin biçimi aynıdır: istemi ve parametreleri gönderir, barındırılan bir video URL'si alırsınız.

Kunavo'da mevcut video: Veo 3

Kunavo, tek bir OpenAI tarzı uç nokta /v1/video/generations ile video oluşturma olanağı sunar. Sora henüz katalogda etkinleştirilmemiştir; mevcut metinden videoya modeli, yerleşik sesli sinematik klipler oluşturan Google Veo 3'tür. Aşağıdaki örnekler veo-3 kullanır — Sora eklendiğinde yalnızca model alanını değiştirmeniz gerekir.

Text-to-video hızlı başlangıç

Kunavo anahtarınızla tek bir POST yeterlidir. Oluşturma 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": "빨간 종이학이 펼쳐지는 영화적인 돌리인, 부드러운 조명",
        "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üye hareket vermek için istemle birlikte image_url(https URL'si veya /v1/files adresine yüklenmiş dosya) gönderin. Kontrollü hareket için ilk ve son kareyi image_urls ve image_mode: "frame" ile gönderebilirsiniz. Tam örnek video belgelerinde bulunur.

Eşzamansız iş yaşam döngüsü

Üretimde 10 dakikalık bir bağlantıyı açık tutmayın. /v1/videos adresine iş gönderdiğinizde hemen bir iş kimliği alır ve tamamlanana kadar GET /v1/videos/{id} adresini yoklarsınız. 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 tam yoklama döngüsünü, idempotency anahtarlarını ve webhook teslimini ele alır.

Fiyatlandırma

Veo 3 video başına ücretlendirilir (burada 8 saniyelik 720p klip temel alınır) ve Google'ın liste fiyatından yaklaşık 50–70% daha ucuzdur. Daha yüksek çözünürlük daha yüksek maliyet getirir — tam seviye tablosu için fiyatlandırma sayfasına bakın.

Video istemi ipuçları

• Yalnızca özneyi değil, çekimi de betimleyin. Kamera hareketi (dolly, pan, push-in), lens hissi, ışıklandırma ve tempo; sıfatlardan daha önemlidir.
• En-boy oranını belirtin — yatay için 16:9, dikey/sosyal medya için 9:16 kullanın.
• 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 (image-to-video). Belirli bir karakteri veya ürünü tutarlı biçimde korumanız gerektiğinde yararlıdır.

Sık sorulan sorular