Görselden Videoya

Görselden Videoya uç noktası, bir metin istemine dayalı olarak yüksek kaliteli bir video animasyonu oluşturarak statik görsellere hayat verir.

Model Adı: image-to-video

Yaşam Döngüsü: deneysel

İşlem Süresi: ~60s–180s

Çıktı Formatı: MP4

Teslimat Yöntemleri: URL (durum sorgulama yoluyla)

Krediler: video başına 6 ila 12 (süreye bağlıdır)

İstek

Görselinizi ve isteminizi evrensel /v1/run uç noktasına göndererek bir video oluşturun:

POSThttps://fititon.app/api/v1/run

İstek Örnekleri

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

Yanıt

Video oluşturma birkaç dakika sürdüğü için, /v1/run uç noktası eşzamansız bir iş id ile hemen 200 OK durumu döndürür. Nihai MP4 URL'sini almak için Durum API'sini GET /v1/status/{id} kullanarak sorgulamanız gerekir. Alternatif olarak, bildirimleri otomatik olarak almak için webhook'ları yapılandırabilirsiniz. Webhook göndericimizin katı bir 15 saniyelik zaman aşımı uyguladığını lütfen unutmayın. Sunucunuz, 15 saniye içinde webhook'u bir 2xx durum koduyla onaylamalıdır, aksi takdirde başarısız sayılacak ve daha sonra tekrar denenecektir.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

İstek Parametreleri

Gerekli Parametreler

imageUrlRequiredstring

Canlandırılacak giriş görseli. Herkese açık bir URL veya Base64 kodlu bir görsel dizesi olabilir.

Profesyonel İpucu: Görünür saç, kumaş veya yaprakları olan görseller en doğal görünümlü hareketi üretir. Statik düz çekim veya yalnızca ürün fotoğrafları iyi canlanmaz — bir kişi veya sahne içeren görseller kullanın. Yapay zekaya hareket alanı sağlamak için ağır kırpılmış görsellerden kaçının.

Biçimlendirme Gereksinimi Bir Base64 dizesi gönderirken, standart veri URI önekini içermelidir (örn. data:image/jpeg;base64,...).

İsteğe Bağlı Parametreler

promptstring

Animasyonu yönlendiren metinsel bir açıklama. Atlanırsa, yapay zeka görsel bağlamından doğal hareketi çıkaracaktır.

durationinteger

Oluşturulan videonun saniye cinsinden uzunluğu. Desteklenen değerler: 4, 6, 8. Varsayılan: 6

aspectRatio'16:9' | '9:16'

Çıktı videosunun en boy oranı. Varsayılan: 9:16

generateAudioboolean

Videoya eşlik edecek bağlamsal yapay zeka sesi oluşturulup oluşturulmayacağı. Varsayılan: true

Çalışma Zamanı Hataları

Bu özellik için çalışma zamanı hataları, Hata İşleme bölümünde belgelenen paylaşılan kümesi kullanır. İşlem sırasında bir hata oluşursa, status "error" olarak güncellenir ve error alanı belirli hata nedenini içerir.

Kredi Maliyeti

Geliştirici API istekleri için maliyet, tamamen istenen video duration değerine bağlıdır.

Formül: Maliyet = SüreKredileri

Süre	Video Başına Kredi
4s	6
6s (Varsayılan)	9
8s	12