Veo 3 ve Sora API hızlı başlangıcı — beş dakikada metinden videoya ve görüntüden videoya

Veo 3 ve Sora, metinden videoya üretimi, metinden görsele üretimin on sekiz ay önce ulaştığı kalite standardına taşıyor. Ancak sağlayıcılar erişimi bekleme listeleri, bölgesel kısıtlamalar ve AI yığınınızın geri kalanıyla uyumlu olmayan özel faturalandırma akışlarının arkasında tutuyor.

Kunavo'da bugün canlı metinden videoya modeli, tek bir OpenAI uyumlu uç nokta üzerinden sunulan Google Veo 3'tür — bekleme listesi yoktur, OpenAI uyumlu kimlik doğrulama kullanılır, video başına ücretlendirilir ve sonuçlar kalıcı bir URL üzerinden sunulur. Sora (sora-2) yol haritasındadır: uç nokta modelden bağımsız olduğu için daha sonra geçiş yapmak yalnızca tek kelimelik bir model değişikliğidir. Bu kılavuz ilk Veo 3 çağrınızı yaklaşık beş dakikada çalıştırmanızı sağlar. Genel görünüm için Sora API kılavuzuna bakın.

Kurulum

1. kunavo.com/app/signup adresinden kaydolun. 10 ABD dolarından başlayan ön ödemeli kullandıkça öde bakiyesi yükleyin — bu tutar, bu kılavuzdaki her örneği birkaç kez çalıştırmak için yeterlidir ve bakiyenizin süresi dolmaz.
2. /app/keys adresinden bir anahtar oluşturun. Anahtar sk-kn- ile başlar.
3. Dışa aktarın: export KUNAVO_API_KEY=sk-kn-....

Veo 3 ile metinden videoya

Veo 3, sinematik çekimler için şu anda piyasadaki en iyi metinden videoya modelidir — kamera dilini (dolly, push-in, rack focus) anlar, kesmeler boyunca kararlı aydınlatma üretir ve 24 fps hareketi doğru şekilde işler. Üretimler 30 saniye ile birkaç dakika arasında sürer; HTTP yanıtı senkrondur, bu nedenle istemci zaman aşımını uzun ayarlayın.

import requests, os, time

KEY = os.environ["KUNAVO_API_KEY"]

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
        "model": "veo-3",
        "prompt": "A drone shot pulling back from a quiet mountain lake at dawn, mist rising off the water. Cinematic, 24fps, soft golden light.",
        "aspect_ratio": "16:9",
        "resolution": "1080p",
    },
    timeout=600,   # generations take 30s to several minutes
)
resp.raise_for_status()
data = resp.json()
print(data["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.

Yanıt OpenAI biçimindedir: { data: [{ url: '...' }] }. URL kalıcıdır ve files.kunavo.com üzerinden sunulur — uzun süreli barındırma gerekiyorsa URL'deki dosyayı bir kez kendi depolamanıza indirin.

Görüntüden videoya

Üretim kalitesinde sonuç almak için genellikle en iyi yöntem bir görselle sabitleme yapmaktır. Veo 3 iki görsel modu destekler:

• image_mode: "frame" — tek görsel ilk kare olur; iki görsel ilk + son kare olur. image_url için varsayılandır.
• image_mode: "reference" — kareleri zorunlu kılmadan karakter / kostüm tutarlılığı için en fazla 3 stil referansı.

# image-to-video: pass an image_url to anchor the first frame.
resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {KEY}"},
    json={
        "model": "veo-3",
        "prompt": "She smiles, then walks out of frame to the left",
        "image_url": "https://files.kunavo.com/<your-upload>.jpg",
        "image_mode": "frame",      # one image => first frame
        "aspect_ratio": "9:16",     # vertical, mobile-native
    },
    timeout=600,
)
print(resp.json()["data"][0]["url"])

Sabitleme görseliniz için henüz herkese açık bir URL yoksa baytları /v1/files adresine gönderin; Kunavo dosyayı sizin için files.kunavo.com altında barındırır:

# If you don't have a public URL, upload bytes; Kunavo hosts the file.
with open("anchor.jpg", "rb") as f:
    up = requests.post(
        "https://api.kunavo.com/v1/files",
        headers={"Authorization": f"Bearer {KEY}"},
        files={"file": f},
    )
image_url = up.json()["url"]   # permanent files.kunavo.com URL

Sora ve diğer modeller

Aynı uç nokta yapısı katalogdaki tüm video modelleriyle çalışır — ilgili model slug'ını gönderin:

• veo-3 — sinematik, 1080p ve görselden videoya üretimi destekler. Şu anda canlıdır.
• seedance-2, seedance-2-5 — ByteDance; karakter hareketlerinde çok güçlüdür.

OpenAI Sora (sora-2) yol haritasındadır — henüz Kunavo'da çağrılamaz. /v1/video/generations modelden bağımsız olduğundan, kullanıma açıldığı gün yukarıdaki çağrılarda yapılacak tek değişiklik model alanıdır; o zamana kadar aynı uç noktadaki canlı eşdeğer Veo 3'tür.

Canlı model listesini ve her modelin fiyatını görmek için /models adresine bakın.

Node / TypeScript ile

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

// /v1/video/generations isn't in OpenAI's SDK shape, but the same auth
// header works — call it with fetch:
const resp = await fetch(
  "https://api.kunavo.com/v1/video/generations",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.KUNAVO_API_KEY}`,
    },
    body: JSON.stringify({
      model: "veo-3",
      prompt: "A red origami crane unfolding into a paper plane and flying away through a window",
      resolution: "1080p",
    }),
  },
);
const { data } = await resp.json();
console.log(data[0].url);

Fiyatlandırma modeli

Video modelleri token başına değil, video başına veya çıktı süresi saniyesi başına ücretlendirilir: Veo modelleri, her klip 8 saniye uzunluğunda olmak üzere video başına; Seedance modelleri ve Wan 2.7 ise saniye başına. Kunavo her modelin ücretini /pricing adresinde yayımlar. 8 saniyelik bir Veo 3 1080p klip $0,42 tutar. Başarısız üretimler (4xx / 5xx) hiçbir zaman ücretlendirilmez.

Üretim kontrol listesi

• HTTP zaman aşımını 10 dakika olarak ayarlayın. Ağ geçidi üst sağlayıcıyı 540 saniyeye kadar sorgular; model bundan sonra hâlâ çalışıyorsa 504 döndürür. Yeniden deneme yeni bir görevdir ve başarıyla tamamlanan her görev ücretlendirilir. Çok uzun işler için isteği bunun yerine /v1/videos adresine gönderin ve döndürdüğü görevi sorgulayın: Idempotency-Key başlığıyla, aynı anahtarla yapılan ikinci gönderim yeni bir görev başlatmak yerine o görevi döndürür.
• Sonuç URL'sini kalıcı olarak saklayın. files.kunavo.com URL'leri kalıcı olsa da ürününüz, kontrol ettiğiniz depolamada kendi kopyasına sahip olmalıdır.
• 429 yanıtlarını yeniden denemeler arasında bekleme süresini artırarak yönetin. Video modelleri GPU kaynaklarıyla sınırlıdır; bu kaynaklar için kısa süreli çekişme normaldir. Mevcut olduğunda retry-after üstbilgisine uyulur.
• Makul olduğu durumlarda istem karmasına göre önbelleğe alın. Aynı istemi iki kez göndermek iki klip üretir ve iki kez ücretlendirilir: ağ geçidi önceki bir sonucu yeniden kullanmaz ve modele seed göndermez.

Sorular: contact@kunavo.com. Ağ geçidinin arkasındaki ekip her e-postayı okur ve 24 saat içinde yanıtlar.