Vidu AI API: Image-to-Video ve Reference Video için Kılavuz

Vidu AI API, tek bir istek ile durağan bir görseli hareketli bir klibe dönüştürür; referans video modu ise mevcut bir klibin hareketini statik bir görsele aktarır. Bu eğitim, TokenLab birleşik API'si aracılığıyla her iki yeteneğe de erişimi, payload yapısını, parametre ayarlamalarını ve pratik bir uygulama kontrol listesini ele almaktadır.

Önemli Çıkarımlar

• Vidu'nun görselden videoya (image-to-video) uç noktası, sabit bir kareden gerçekçi hareketler üretir; referans video modu ise bir videodaki hassas hareket kalıplarını hedef görselin içeriğine kopyalar.
• TokenLab; Seedance, Veo 3, Kling, Hailuo ve PixVerse V6 gibi Vidu ve diğer video modellerini tek ve tutarlı bir API üzerinden sunar, böylece entegrasyon kodunuzu değiştirmeden kalite, hız ve maliyet karşılaştırması yapabilirsiniz.
• motion_intensity, num_frames ve reference_video gibi parametreler çıktı stilini, süresini ve sadakatini doğrudan kontrol eder; bunları ayarlamak üretim gecikmesini ve sonuç kalitesini etkiler.
• Fiyatlandırma ve model kullanılabilirliği sık sık değişmektedir; en güncel detaylar için her zaman TokenLab model dizinini ve fiyat karşılaştırma sayfasını kontrol edin (her ikisi de 2026-07-07 tarihinde gözlemlenmiştir).

Vidu'nun Görselden Videoya ve Referans Video Modlarını Anlamak

Vidu'nun görselden videoya hattı, statik bir girdi görselini ilk kare olarak kabul eder ve kalan kareleri video verilerinden öğrenilen bir hareket ön bilgisi (motion prior) kullanarak doldurur. Model, optik akışı ve sahne semantiğiyle tutarlı görünüm değişikliklerini tahmin ederek, genellikle num_frames ve seçilen çözünürlüğe bağlı olarak 2 ila 10 saniyelik kısa bir video klibi çıktısı verir.

Bazen hareket aktarımı veya video destekli üretim olarak adlandırılan referans video modu, ek bir reference_video parametresini kabul eder. Model, referans klipten hareket vektörlerini çıkarır ve bunları statik görselin içeriğine uygular. Örneğin, bir dansçının bir videodaki hareketleri bir portre fotoğrafına aktarılabilir veya bir ürün tanıtımının kamera kaydırma hareketi farklı bir ürün görseline eşlenebilir. Her iki mod da TokenLab'de aynı API uç noktasını paylaşır; tek fark, istekte bir reference_video alanının bulunmasıdır.

Bir istemden (prompt) hareket uyduran metinden videoya modellerinin aksine, Vidu'nun görsel odaklı yaklaşımı, başlangıç karesi üzerinde ve referans video ile tam hareket koreografisi üzerinde hassas kontrol sağlar. Bu, statik konsept sanatını canlandırmak, ürün fotoğraflarına ikincil hareketler eklemek veya tek bir referanstan karakter animasyon testleri oluşturmak için uygundur. Model gerçek bir ilk kare ile çalıştığından, üretilen klip girdinin görsel kimliğine bağlı kalır ve yalnızca istem tabanlı hatlarda yaygın olan şekil bozulması (shape-drift) sorunlarını önler.

TokenLab Hesabınızı ve API Anahtarınızı Kurma

Vidu'yu TokenLab üzerinden kullanmak için aktif bir hesaba ve bir API anahtarına ihtiyacınız vardır.

1. tokenlab.sh adresinden kaydolun.
2. Kontrol panelinize gidin ve API Keys bölümünden bir API anahtarı oluşturun.
3. Anahtarı güvenli bir şekilde saklayın: her istekte bir bearer token olarak gönderilecektir.

TokenLab'in birleşik API'si, payload içindeki model alanını değiştirerek video modelleri arasında geçiş yapmanızı sağlar. Vidu, vidu ismiyle tanımlanır. Seedance veya Veo 3 gibi modeller için mevcut entegrasyon kodunuz, yapısal değişiklikler olmadan Vidu ile çalışacaktır.

TokenLab ile İlk Vidu API İsteğinizi Yapma

Temel bir görselden videoya isteği, statik bir görsel URL'si ve bir dizi üretim parametresi gönderir. İşte curl kullanan bir örnek:

curl -X POST "https://api.tokenlab.sh/v1/video/generate" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu",
    "image_url": "https://example.com/portrait.jpg",
    "motion_intensity": 0.7,
    "num_frames": 120,
    "resolution": "1080p"
  }'

Referans video modu için, kısa bir hareket klibini işaret eden bir reference_video parametresi ekleyin:

{
  "model": "vidu",
  "image_url": "https://example.com/portrait.jpg",
  "reference_video": "https://example.com/dance_reference.mp4",
  "motion_intensity": 0.8,
  "num_frames": 120
}

API, üretim tamamlanana kadar sorgulayabileceğiniz bir video_url içeren bir JSON nesnesi döndürür. TokenLab, üretim iş yükleri için tercih edilen yaklaşım olan sorgulamayı (polling) önlemek adına webhook geri aramalarını da destekler.

Kalite ve Hız İçin Parametre Ayarlama

Vidu uç noktası, hareket gerçekçiliğini, çıktı süresini ve işlem süresini etkileyen birkaç parametreyi kabul eder. Aşağıdaki tablo en önemlilerini özetlemektedir.

Parametre	Tip	Açıklama	Tipik Aralık
motion_intensity	float	Hareketin genliğini kontrol eder. Düşük değerler hafif hareketler üretir; yüksek değerler daha dramatik eylemler oluşturur.	0.0 – 1.0
num_frames	int	Üretilecek kare sayısı. Çıktı süresi num_frames / fps şeklindedir (varsayılan fps 24'tür). Daha yüksek değerler üretim süresini artırır.	48 – 240
resolution	string	Çıktı çözünürlüğü. Desteklenen değerler 720p ve 1080p'dir. Daha yüksek çözünürlük daha maliyetli ve daha uzun sürer.	720p, 1080p
reference_video	string	Hareket aktarımı için referans video URL'si. Belirtilmediğinde model hareketi otonom olarak üretir.	URL
style_strength	float	Modelin girdi görselinin görsel stiline ne kadar bağlı kalacağı ile referans hareketi arasındaki denge. 1.0 değeri görsel stilini korur; düşük değerler referans videonun stilinin hafifçe içeri sızmasına izin verir.	0.0 – 1.0

Bu parametreleri tam süreye ölçeklemeden önce kısa bir klipte (48–60 kare) test etmek hem zamandan hem de maliyetten tasarruf sağlayabilir. TokenLab fiyatlandırma sayfası, çözünürlüğe ve kare sayısına göre değişen gerçek zamanlı üretim başına maliyetleri gösterir. Model dizini ayrıca Vidu'nun barındırıldığı Replicate ve fal gibi resmi sağlayıcıları listeler; bunların fiyatlandırması bağımsız olarak gözlemlenir: güncel oranları için Replicate fiyatlandırması ve fal fiyatlandırması sayfalarını kontrol edin (2026-07-07 tarihinde gözlemlenmiştir).

Pratik Uygulama Kontrol Listesi

Canlıya geçmeden önce, entegrasyonunuzun üretime hazır olduğunu doğrulamak için bu kontrol listesini kullanın.

• API anahtarı doğru kapsamlandırıldı – Anahtar, video üretimi için gerekenden daha geniş izinlere sahip değil.
• Girdi görseli doğrulandı – Görsel URL'si herkese açıktır ve en az 512×512 pikseldir; model en iyi net, iyi aydınlatılmış yüzler veya nesnelerle çalışır.
• Referans video hazırlandı – Hareket aktarımı kullanılırken, referans klip kısa (2–5 saniye), iyi kırpılmış ve sahne kesintisi olmadan tek bir sürekli hareket içeriyor.
• Parametre ayarlamaları tamamlandı – motion_intensity ve num_frames bir örnek üzerinde test edildi; seçilen denge gecikme bütçenizi ve görsel kalite eşiğinizi karşılıyor.
• Sorgulama veya webhook yapılandırıldı – İstemci, ana iş parçacığını engellememek için video_url durumunu sorguluyor veya tamamlanma webhook'unu dinliyor.
• Hata yönetimi mevcut – Kod, 5xx hatalarında düzgün bir şekilde yeniden deniyor ve hata ayıklama için tüm 4xx yanıtlarını günlüğe kaydediyor.
• Maliyet izleme etkinleştirildi – TokenLab kontrol panelinizde bir harcama limiti belirlendi ve maliyetler değiştikçe fiyat karşılaştırma sayfasını düzenli olarak referans alıyorsunuz.
• Model yedeği düşünüldü – Vidu geçici olarak kullanılamazsa, Seedance veya Veo 3'e geçmek TokenLab'de yalnızca bir model alanı değişikliği gerektirir.

Bu adımları takip etmek, video modeli arzı değişse bile hattınızın güvenilir kalmasına yardımcı olur.

Vidu'yu Diğer Video Modelleriyle Karşılaştırma

TokenLab'in birleşik API'si, entegrasyon kodunu yeniden yazmadan Vidu'yu diğer birkaç video üreticisiyle test etmenizi sağlar. Yazının yazıldığı tarihteki (2026-07-07) birincil alternatifler Seedance, Veo 3, Kling, Hailuo ve PixVerse V6'dır; hepsi aynı uç nokta altında mevcuttur. Her birinin kendine özgü güçlü yönleri vardır:

• Seedance – Yüksek kare hızında, akıcı karakter animasyonunda mükemmeldir; genellikle dans ve aksiyon sahneleri için tercih edilir.
• Veo 3 – Sinematik kamera hareketleri ve sahne kompozisyonu üretir; ürün videoları ve kısa filmler için güçlüdür.
• Kling – Gerçekçi insan hareketi ve dudak senkronizasyonu için optimize edilmiştir; konuşan kafa avatarları için kullanışlıdır.
• Hailuo – Stilize, animasyonlu efektlere odaklanır; hareketli grafikler için iyi çalışır.
• PixVerse V6 – Toplu sosyal medya klipleri için hız ve kaliteyi dengeler.

Bu modellerin yan yana çıktı örnekleri ve kullanım durumu önerileri dahil olmak üzere ayrıntılı bir dökümü, en iyi yapay zeka video modelleri API 2026 makalesinde mevcuttur. Maliyete göre sağlayıcılar arasında yönlendirme yapması gereken geliştiriciler için, OpenRouter karşılaştırma rehberi, TokenLab'in çoklu sağlayıcı erişimini nasıl soyutladığını ve harcamalarınızı nasıl en aza indirebileceğinizi açıklar.

SSS

1. Vidu, bir görselin yanı sıra metin istemlerini de destekliyor mu?
   Vidu öncelikle görsel odaklı bir modeldir; görsel ilk kare görevi görür ve hareket ön bilgisi hareketi belirler. Bazı sağlayıcılar stili yönlendirmek için isteğe bağlı bir metin ipucuna izin verse de, TokenLab üzerinden sağlanan API şu anda bir prompt alanını kabul etmemektedir. Çıktıyı etkilemenin en iyi yolu motion_intensity, num_frames değerlerini ayarlamak ve en önemlisi uygun bir referans video kullanmaktır.

2. Tipik bir üretim ne kadar sürer?
   Üretim gecikmesi num_frames, çözünürlük ve sağlayıcı yüküne bağlıdır. 720p'de (48 kare) 2 saniyelik bir klip TokenLab'de genellikle 15-30 saniyede tamamlanır. 1080p'de 5 saniyelik bir klip (120 kare) 60-90 saniye sürebilir. Zaman açısından kritik uygulamalar için webhook teslimatı önerilir.

3. Yerel olarak barındırılan görselleri veya videoları kullanabilir miyim?
   TokenLab, image_url ve reference_video için herkese açık URL'ler gerektirir. Dosyaları bir bulut depolama alanına (örneğin, önceden imzalanmış bir URL ile Amazon S3) yükleyebilir veya geçici bir barındırma hizmeti kullanabilirsiniz. Vidu'nun temel sağlayıcıları (Replicate, fal) da varlık getirme için URL'ler gerektirir.

TokenLab ile Vidu'ya Başlayın

Vidu AI API, görselden videoya ve hareket aktarımı projeleriniz için hazırdır. Bir TokenLab hesabına kaydolun, API anahtarınızı alın ve ilk test isteğinizi bugün gönderin. Vidu'yu seçmek ve diğer video üreticileriyle karşılaştırmak için TokenLab model dizinini keşfedin veya maliyetlerinizi optimize etmek için fiyat karşılaştırma sayfasına göz atın. Tek bir API ile tüm video modeli serisine erişim sağlarsınız; entegrasyon değişikliğine gerek kalmaz.