Metinden videoya API — bir istemden video oluşturma (OpenAI uyumlu, 2026)

Metinden videoya API, bir metin istemini kısa bir video klibine dönüştürür — bunu programatik olarak yaptığı için oluşturmayı bir tüketici uygulamasında tıklamak yerine işlem hatlarına betiklerle ekleyebilirsiniz. Bu kılavuz, modern video modellerinde yaygın olan API yapısını, bugün Kunavo'da kullanıma açık modelleri, klip başına fiyatlandırmayı ve üretimde ihtiyaç duyduğunuz eşzamansız modeli kapsar.

Metinden videoya API nasıl çalışır?

Modern video modellerinin hepsinde yapı aynıdır: bir prompt ve parametreler (duration, aspect_ratio, resolution) gönderir, barındırılan bir video URL'si alırsınız. Kunavo bunu tek bir OpenAI tarzı endpoint olan /v1/video/generations üzerinden sunar; bu nedenle yeni bir SDK veya entegrasyon olmadan yalnızca model dizesini değiştirerek video modelleri arasında geçiş yaparsınız.

import requests

# One OpenAI-style endpoint for every text-to-video model.
resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",                       # swap the model, same request
        "prompt": "a cinematic dolly-in on a red origami crane unfolding",
        "aspect_ratio": "16:9",
    },
    timeout=600,  # generation takes 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.

Kunavo'daki metinden videoya modeller

Bugün üç aile kullanıma açıktır: Google Veo 3 (yerleşik sesle sinematik kalite), ByteDance Seedance 2 (çoklu çekim hikâye anlatımı ve referans tutarlılığı) ve Alibaba Wan 2.7 (bütçe dostu sinematik, saniye başına ücretlendirme). Sora, Kling ve Hailuo yol haritasındadır; endpoint modelden bağımsız olduğundan bunlardan herhangi birini kullanmaya başlamak model alanında tek kelimelik bir değişikliktir.

Fiyatlandırma

Veo 3 video başına ücretlendirilir (burada gösterilen 720p, 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 — pricing page tam katman tablosunu, AI video cost calculator ise bir aylık kullanımı fiyatlandırır; buna klip başına ve saniye başına ayrım da dahildir. Benzer görünen iki oranın çok farklı faturalar üretmesinin nedeni budur.

Görüntüden videoya

Bir sabit görüntüyü canlandırmak için istemin yanında image_url (bir https URL'si veya yüklenmiş dosya) gönderin; kontrollü geçişler için ilk ve son kareyi gönderin. Tüm parametreler video docs sayfasındadır.

Konuşma ve video: bu endpoint ne yapar, ne yapmaz?

“Speech to video” ifadesi iki farklı şey için aranır ve burada hangisinin mevcut olduğunu kesin olarak belirtmek gerekir.

Oluşturulmuş konuşmalı video — evet. Veo 3, oluşturmanın bir parçası olarak yerleşik senkronize ses üretir: aynı metin isteminden görüntüyle zamanlanmış diyalog, ortam sesi ve efektler. Söylenmesini istediğiniz cümleyi istemde açıklayın; bu cümle, dönen MP4 dosyasının ses kanalında yer alır. Ayrı bir ses modeli, ikinci bir API çağrısı veya yapım sonrası senkronizasyon adımı gerekmez. Bu özellik özellikle Veo 3 ailesine aittir — Seedance 2 ve Wan 2.7 sessiz video üretir.

Bir ses dosyasından video üretme — hayır. Bir kayıt yükleyip dudak senkronlu konuşan bir avatar almak veya konuşmayı yazıya döküp bundan storyboard oluşturmak istiyorsanız, Kunavo'da bugün bunun için bir model yoktur. Buradaki video modelleri bir metin istemi ve isteğe bağlı bir kaynak görüntü alır; hiçbiri sesi girdi olarak kabul etmez. Eksiksiz olması için: /v1/audio/transcriptions şu anda etkin bir modele de sahip değildir; dolayısıyla iki adımlı sürümü yalnızca bu API üzerinde oluşturamazsınız. Kullanım alanınız buysa bu yanlış araçtır; var olmayan bir geçici çözümü satmak yerine bunu açıkça söylemek daha doğrudur.

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

Oluşturma dakikalar sürdüğü için üretimde bağlantıyı açık tutmazsınız. /v1/videos uç noktasına bir görev gönderir, hemen bir görev kimliği alır, ardından görev tamamlanana kadar GET /v1/videos/{id} isteğiyle durumu yoklarsınız. Sonuç URL'leri kalıcıdır.

# Production: submit a task and poll — don't hold a long connection.
task = requests.post(
    "https://api.kunavo.com/v1/videos",
    headers={"Authorization": f"Bearer {API_KEY}",
             "Idempotency-Key": "my-task-uuid"},
    json={"model": "veo-3", "prompt": "..."},
    timeout=60,
).json()
# then poll GET /v1/videos/{task["id"]} until status == "completed"

Sekiz model arasında seçim yapma

Bu sayfa endpoint'i kapsar. Para sorusu — her modelde 8 saniyelik 720p bir klibin maliyeti ve klip uzunluklarına göre klip başına ve saniye başına ücretlendirmenin neden farklı modelleri öne çıkardığı — için video generation API comparison sayfasına bakın.

Sık sorulan sorular