Dokümantasyona geç
Bu sayfada

Seedance 2.5 Flash

Metin, ilk ve son kareler veya çok modlu referanslar kullanarak Seedance 2.5 Flash ile videolar üretin. Bu sayfa, bu modele ait istekten sonuca kadar olan tüm iş akışını kapsar.

API model kimliği: seedance-2-5-flash

Üretim asenkrondur. Görev oluşturulduğunda dönen taskId değerini kaydedin, ardından durumunu sorgulayın veya bir webhook alın.

Yetenekler

Seedance 2.5 Flash, varsayılanı 720p olmak üzere 480p ve 720p çözünürlüklerini destekler. 1080p, 4k, Taslak önizlemeleri veya Taslak kesinleştirmeyi desteklemez.
ÖzellikDesteklenen değerler
Çıkış çözünürlüğü480p · 720p
Çıkış süresi4–30 saniye
En boy oranı16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
Referans görseller30 adede kadar görsel
Referans videolar10 adede kadar video
Referans ses dosyaları10 adede kadar ses dosyası
Tüm referansların toplamıToplam 50 adede kadar kaynak dosya
Video/ses grubu başına toplam süre30 saniye
seed-1 ile 2147483647
Referanstan videoya modunda duration=-1 değerini de kabul eder; aşağıdaki video düzenleme ve fiyatlandırma bölümüne bakın. image-to-video yalnızca adaptive değerini kabul eder; bu alanı boş bırakın veya adaptive olarak ayarlayın.

Fiyatlandırma ve krediler

Video oluşturma işlemi, saniye cinsinden faturalandırılabilir süreye göre krediyle ücretlendirilir. Video girdisi olmadığında, faturalandırılabilir süre çıktı süresidir; video girdisi olduğunda ise referans video süresi de bu süreye dahil edilir.

Aşağıdaki tabloda, bir görevin toplam maliyeti değil, saniye başına tahsil edilen kredi miktarı listelenmiştir. Ücretlendirme oranı modele, çıktı çözünürlüğüne ve referans videodan videoya modunda referans videoların sağlanıp sağlanmadığına bağlıdır. Toplam maliyet hesaplaması için tablonun altındaki formüllere ve örneklere göz atabilirsiniz.

Çıkış çözünürlüğüVideo girişi olmadanVideo girişi ile
480p7 kredi/saniye5 kredi/saniye
720p10 kredi/saniye7 kredi/saniye
  • Video girişi olmadan: çıkış saniyesi × video içermeyen ücret.
  • Video girişi ile: (çıkış saniyesi + ölçülen referans video saniyesi) × videolu ücret. Sunucu, toplam referans video süresini ölçer ve faturalandırmadan önce yukarıya doğru tam saniyeye yuvarlar.
  • Yalnızca görsel veya ses referanslarının kullanılması, videosuz ücret üzerinden değerlendirilir. Referans video faturalandırma ücreti, yalnızca referans videolar sağlandığında referanstan videoya modunda geçerlidir.

Ücret hesaplama örnekleri

5 saniyelik 720p metinden videoya: 5 × 10 = 50 kredi.

5 saniyelik referans video ile 5 saniyelik 720p çıkış: (5 + 5) × 7 = 70 kredi.

Bu krediler, görev oluşturulduğunda önceden düşülür. Görev başarıyla tamamlanırsa bu tutar nihai ücret olarak kabul edilir; gerçek çıktı süresine bağlı olarak herhangi bir ekleme yapılmaz veya kısmi iade sağlanmaz. Başarısız olan veya zaman aşımına uğrayan görevler için iade süreci başlatılır.

Krediler istek gönderildiğinde rezerve edilir ve işlem başarıyla tamamlandığında tahsil edilir. Başarısız olan veya zaman aşımına uğrayan görevler iade sürecine girer. refund_failed fatura durumu, iadenin tamamlanamadığı anlamına gelir; API günlüklerini kontrol edin veya destek ekibiyle iletişime geçin.

duration=-1 olduğunda krediler nasıl düşülür?

Süre -1 olarak ayarlandığında, nihai çıktı süresi sabitlenmez ve model tarafından belirlenir.

Çoğu durumda, süreyi -1 yapmak yerine doğrudan ihtiyacınız olan video uzunluğuna ayarlayın. -1 değerini diğer video üretme senaryoları için değil, yalnızca video düzenleme işlemleri için kullanmanızı öneririz.

Referans girdileriÜcretin hesaplanma yöntemiÖrnek
Referans videolar varsaTüm referans videoların süreleri toplanır ve toplam süre en yakın tam saniyeye yukarı yuvarlanarak T olarak tanımlanır. Ücret, (T + T) × videolu ücret tarifesi şeklinde hesaplanır: T değerlerinden biri tahmini çıktı süresini, diğeri ise girdi videosunun süresini temsil eder.5 saniyelik referans videoya sahip 720p içerik: (5 + 5) × 7 = 70 kredi.
Referans videolar yoksa (yalnızca görsel veya ses)Tahmini çıktı süresi 30 saniye olarak kabul edilir. Ücret, 30 × videosuz ücret tarifesi şeklinde hesaplanır.Referans videosuz 720p içerik: 30 × 10 = 300 kredi.

Kimlik doğrulama

Panelde bir API anahtarı oluşturun. Anahtarın tamamı yalnızca bir kez gösterilir. Bu anahtarı sunucunuzda saklayın ve her istekte Bearer token olarak gönderin.

Temel URL

https://api.seevio.ai
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Bu örnekleri çalıştırmadan önce SEEVIO_API_KEY ortam değişkenini tanımlayın. JavaScript örnekleri sunucunuzda Node.js ile çalışır; Python örnekleri ise requests paketini kullanır.

Hızlı başlangıç

Bu temel isteği gönderin, dönen taskId değerini kaydedin ve ardından aşağıdaki görev sorgulama örneğini kullanın. İstek oluşturma yanıtındaki credits değeri, ayrılan (rezerve edilen) miktarı gösterir.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Görev oluşturma yanıtı örneği

Yukarıdaki istek kabul edildikten sonra API bu JSON yanıtını döndürür. taskId, sonraki durum sorgulamalarında kullanılan görev tanımlayıcıdır; credits ise bu görev için ayrılan kredi miktarını gösterir. Bu yanıt yalnızca görevin oluşturulduğunu onaylar, videonun hazır olduğu anlamına gelmez. Video sonuçlarını almak için görev durumunu düzenli olarak sorgulamanız (poll) veya bir Webhook kullanmanız gerekir.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

Görev oluştur

POST https://api.seevio.ai/v1/videos/generations

model, input ve isteğe bağlı bir callback_url içeren bir JSON nesnesi gönderin. Her zaman bu sayfada gösterilen model ID'sini belirtin; model belirtilmezse varsayılan olarak seedance-2-0 seçilir.

İstek gövdesi

AlanTürZorunluAçıklama ve kısıtlamalar
model
stringEvet

Model kimliği. Seedance 2.5 Flash kullanmak için bu alanı seedance-2-5-flash olarak ayarlayın.

callback_url
stringHayır

Tamamlanma ve başarısızlık POST geri çağrıları (callback) için genel erişime açık HTTPS uç noktası. Özel ağlara ve localhost adresine izin verilmez.

Örnek: https://example.com/webhooks/seevio
input
objectEvet

Üretim ayarları. Boş olmayan bir prompt (istem) içermelidir.

Giriş parametreleri

image_urls alanı image-to-video modunda zorunludur. reference-to-video modu, image_urls, video_urls ve audio_urls arasından en az bir referans gerektirir.

image_urls, video_urls ve audio_urls değerlerini URL dizesi dizileri (string[]) olarak sağlayın. Gönderilen tüm URL'lerin, seçilen mod tarafından yok sayılan medyalar da dahil olmak üzere, HTTPS üzerinden herkese açık olarak erişilebilir olması gerekir.

AlanTürZorunluVarsayılanAçıklama ve kısıtlamalar
input.prompt
stringEvet—

Her modda bir istem (prompt) girilmesi zorunludur. İstem, kırpılmadan önce en fazla 10.000 karakterden oluşabilir ve yalnızca boşluk karakterlerinden oluşamaz.

Örnek: A cat surfing at sunset
input.generation_type
stringHayırtext-to-video
Desteklenen değerler
text-to-video | image-to-video | reference-to-video

text-to-video, image-to-video veya reference-to-video. Belirtilmezse varsayılan olarak text-to-video seçilir ve yalnızca prompt kullanılır. image-to-video sıralı 1-2 kare görseli kullanır. reference-to-video görsel, video ve/veya ses kullanır; prompt zorunlu olmak kaydıyla yalnızca ses referansları desteklenir.

input.image_urls
string[]Koşullu[]

Görünümü yönlendirmek için görsel URL'leri sağlayın. image-to-video modunda ilk kare için 1 görsel veya ilk kare, son kare sırasında 2 görsel sağlayın. reference-to-video modunda en fazla 30 görsel sağlayın. Her bir görsel 30 MB'tan küçük olmalıdır; formatlar ve boyutlar için aşağıdaki medya gereksinimlerine bakın. Tüm referans türleri bir arada en fazla 50 dosyaya izin verir. Belirtilmezse varsayılan olarak [] kabul edilir; text-to-video modunda yoksayılır.

Örnek: ["https://example.com/first-frame.jpg"]
input.video_urls
string[]Koşullu[]

Yalnızca reference-to-video modunda olmak üzere, harekete yön vermek veya bir videoyu düzenlemek/uzatmak için referans video URL'leri sağlayın. Her biri en fazla 100 MB ve 2–30 saniye uzunluğunda en fazla 10 dosya; bunların birleşik süresi 30 saniyeyi aşmamalıdır. Tüm referans türleri bir arada en fazla 50 dosyaya izin verir. Sunucu, faturalandırma için video süresini ölçer. Belirtilmezse varsayılan olarak [] kabul edilir; diğer modlarda yoksayılır.

Örnek: ["https://example.com/source.mp4"]
input.audio_urls
string[]Koşullu[]

Yalnızca reference-to-video modunda olmak üzere, sese yön vermek için referans ses URL'leri sağlayın. Her biri en fazla 15 MB ve 2–30 saniye uzunluğunda en fazla 10 MP3/WAV dosyası; bunların birleşik süresi 30 saniyeyi aşmamalıdır. Tüm referans türleri bir arada en fazla 50 dosyaya izin verir. Ses, tek referans türü olabilir; prompt kullanımı zorunludur. Belirtilmezse varsayılan olarak [] kabul edilir; diğer modlarda yoksayılır.

Örnek: ["https://example.com/music.mp3"]
input.duration
integerHayır5
Desteklenen değerler
-1 | 4–30

4 ile 30 saniye arasında tam sayı çıkış süresi. Yalnızca reference-to-video modunda olmak üzere -1 değerini de kabul eder. Düzenleme için bir kaynak video ile birlikte kullanın; faturalandırma yukarıdaki özel kurala tabidir.

Örnek: 5
input.aspect_ratio
stringHayıradaptive
Desteklenen değerler
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

16:9, 4:3, 1:1, 3:4, 9:16, 21:9 veya adaptive. Belirtilmezse varsayılan olarak çıktı oranını modelin belirlemesine izin veren adaptive seçilir. Video düzenleme veya uzatma için adaptive kullanın. image-to-video yalnızca adaptive değerini kabul eder; bu alanı boş bırakın veya adaptive olarak ayarlayın.

Örnek: adaptive
input.resolution
stringHayır720p
Desteklenen değerler
480p | 720p

480p veya 720p. Belirtilmezse, desteklenen tüm üretim modlarında varsayılan olarak 720p seçilir. Daha yüksek çözünürlükler reddedilir.

Örnek: 720p
input.generate_audio
booleanHayırtrue
Desteklenen değerler
true | false

true senkronize ses talep eder; false ses üretimini devre dışı bırakır. Belirtilmezse varsayılan olarak true seçilir. Desteklenen tüm üretim modları için geçerlidir.

Örnek: true
input.watermark
booleanHayırfalse
Desteklenen değerler
true | false

true çıktı üzerinde yapay zeka filigranı talep eder; false filigransız çıktı talep eder. Belirtilmezse varsayılan olarak false seçilir. Desteklenen tüm üretim modları için geçerlidir.

Örnek: false
input.web_search
booleanHayırfalse
Desteklenen değerler
true | false

true model için mevcut olduğunda web aramasına izin verir; false bunu devre dışı bırakır. Belirtilmezse varsayılan olarak false seçilir. Etkinleştirilmesi, bir arama yapılacağını garanti etmez.

Örnek: false
input.return_last_frame
booleanHayırfalse
Desteklenen değerler
true | false

true üretilen videonun son karesini talep eder; false bunu talep etmez. Belirtilmezse varsayılan olarak false seçilir. Desteklenen tüm üretim modları için geçerlidir. İstendiğinde ve mevcut olduğunda, URL data.last_frame_url olarak döner; aksi takdirde null olur.

Örnek: true
input.seed
integerHayır—
Desteklenen değerler
-1 ile 2147483647

-1 ile 2147483647 arasında tam sayı. -1 rastgele bir tohum seçer.

Örnek: 42
input.output_format
stringHayırmp4
Desteklenen değerler
mp4 | mov

mp4 veya mov. Belirtilmezse varsayılan olarak mp4 seçilir. Desteklenen tüm üretim modlarında çıktı kapsayıcı formatını seçer.

Boole alanları dize veya sayı değil, JSON true veya false olmalıdır.

Yanıt oluştur

HTTP 200, taskId (dize) ve credits (sayı) döndürür. Bu, görevin tamamlandığını değil, oluşturulduğunu onaylar. Aşağıdaki miktar, 5 saniyelik 720p hızlı başlangıç değerine karşılık gelir.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

Üretim modları ve örnekler

example.com medya URL'lerini kendi genel erişime açık HTTPS dosyalarınızla değiştirin. Örnek URL'ler istek yapısını göstermek amaçlıdır ve indirilebilir örnek varlıklar değildir.

Metinden videoya

Bir metin isteminden video üretin. Medya URL'leri bu modda iletilmez.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

İlk kare

İlk kare olarak tek bir görsel sağlayın, ardından isteminizde hareketi tanımlayın.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

İlk ve son kareler

Sırasıyla iki görsel URL'si sağlayın: önce ilk kare, ardından son kare. Bu örnek aynı zamanda üretilen videonun son karesini de talep eder.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

Çok modlu referans

Görsel, video ve ses referanslarını birleştirin. İstem alanı yine de zorunludur. Referans video girişi faturalandırma formülünü değiştirir.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Ses referansı

İstenen videoyu tanımlayan zorunlu bir metin istemiyle birlikte, tek referans türü olarak ses kullanın.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

Video düzenleme

Seedance 2.5 Flash video düzenleme işlemi için sürenin -1, en boy oranının (aspect_ratio) ise "adaptive" olarak ayarlanması gerekir. Oluşturma işleminin başarıyla tamamlanması için bu iki ayarın da yapılması zorunludur.

Yapılacak düzenlemeyi tanımlayın ve kaynak videoyu sağlayın. duration=-1 olarak ayarlayın ve adaptif en boy oranı kullanın. Bu iş akışı için en az 4 saniyelik bir kaynak klip kullanın. duration=-1 için faturalandırma kuralı yukarıda gösterilmiştir.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Video uzatma

Seedance 2.5 Flash video uzantısı için aspect_ratio değeri adaptive olarak ayarlanmalıdır; aksi takdirde oluşturma işlemi başarısız olabilir. duration değerini, desteklenen aralıkta olmasını istediğiniz çıkış videosu uzunluğuna göre normal şekilde ayarlayın; -1 değerini kullanmanıza gerek yoktur.

Kaynak videonun nasıl devam etmesi gerektiğini tanımlayın. Adaptif en boy oranı kullanın ve modelin sınırları dahilinde normal bir çıkış süresi ayarlayın.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Görev sorgula

GET https://api.seevio.ai/v1/tasks/{taskId}

Örnek kimliği, oluşturma sırasında dönen taskId ile değiştirin. Sorgular yalnızca API anahtarının sahibine ait görevleri döndürür; erişilemeyen veya bilinmeyen kimlikler HTTP 404 döndürür.

Başlangıçta her 10-20 saniyede bir sorgulama yapın, HTTP 429 hatasında sıklığı azaltın ve durum completed veya failed olduğunda sorgulamayı durdurun. Üretim ortamında webhook'ları tercih edin. Aşağıdaki her kod örneği tek bir sorgu gerçekleştirir.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"
DurumAçıklama ve kısıtlamalar
queuedKabul edildi ve işlenmek üzere bekleniyor.
generatingÜretim devam ediyor.
completedBaşarılı sonuçlanma. Süre dolmadan önce data.results altındaki dosyaları indirin.
failedBaşarısız sonuçlanma. failed_reason ve billing_status alanlarını inceleyin.
AlanTürAçıklama ve kısıtlamalar
idstring
Görev tanımlayıcı. Bu, oluşturma yanıtındaki taskId değeridir.
created_atnumber
Unix saniyesi olarak görevin oluşturulma zamanı.
modelstring
Bu görev için kullanılan genel model kimliği.
billing_statusstring
reserved (rezerve edildi), charged (tahsil edildi), refunded (iade edildi) veya refund_failed (iade başarısız).
creditsnumber
Bu görev için rezerve edilen kredi. Bu değer iade sonrasında da korunur; faturalandırma sonucunu belirlemek için billing_status alanını inceleyin.
failed_reasonstring | null
Başarısız görevlerdeki başarısızlık nedeni; aksi takdirde null. Başarısız sorgu yanıtlarında data alanı yer almaz.
dataobject
Başarısız olmayan görev sorgularında bulunur. Çıkış ve işlem detaylarını içerir.
data.resultsstring[]
Video URL dizisi. Tamamlanana kadar veya videonun süresi dolduktan sonra boştur.
data.video_expires_atstring | null
ISO 8601 zaman damgası olarak videonun son geçerlilik tarihi veya video henüz hazır değilse null. Sonucu bu süreden önce kaydedin.
data.last_frame_urlstring | null
Talep edildiğinde ve mevcut olduğunda son kare URL'si, aksi takdirde null.
data.processing_timenumber | null
Mevcut olduğunda saniye cinsinden görevin işlem süresi, aksi takdirde null.

Tamamlanan görev: video sonuçlarını içeren sorgu yanıtı

Sorgu status=completed değerini döndürdüğünde video üretimi tamamlanmış demektir. Video URL'lerini data.results alanından okuyabilir ve data.video_expires_at tarihinden önce indirebilirsiniz. billing_status=charged ifadesi, rezerve edilen kredilerin tahsil edildiğini gösterir.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "completed",
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Başarısız görev: hata ve faturalandırma ayrıntılarını içeren sorgu yanıtı

Sorgu status=failed değerini döndürdüğünde üretim süreci başarısızlıkla sonuçlanmış demektir. Hatanın nedenini öğrenmek için failed_reason alanını, iade sonucunu görmek için ise billing_status alanını inceleyebilirsiniz. Bu örnekteki refunded ifadesi, kredilerin iade edildiğini gösterir. credits alanı orijinal rezerve edilen miktarı korur ve yanıt data alanını içermez.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5-flash",
  "is_draft": false,
  "draft_task_id": null,
  "status": "failed",
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed"
}

Webhook'lar

Görev tamamlandığında veya başarısız olduğunda bir JSON POST isteği almak için oluşturma isteğinde callback_url alanını ayarlayın. 15 saniye içinde bir 2xx yanıtı döndürün. İletilemeyen bildirimler tekrar denenir; yinelenen bildirimleri görev kimliğine göre tekilleştirerek (idempotent) işleyin.

Geri arama (callback) uç noktanız, JSON istek gövdesine (Content-Type: application/json) sahip POST isteklerini kabul etmelidir.

Geri çağırma (callback) ile görev oluşturma

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-5-flash",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "seed": 42,
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Görev tamamlandı: Başarılı geri arama yükü

Oluşturma işlemi başarıyla tamamlandığında, geri arama status=completed değerini döndürür. Görevi tanımlamak için id parametresini, video URL'lerini almak için ise data.results parametresini kullanın. Sonuçları data.video_expires_at tarihinden önce indirip kaydetmeyi unutmayın.

created_at olayın, task_created_at görevin oluşturulma zamanıdır; ikisi de Unix saniyesidir. Örnekler önerilen alanları gösterir; yanıtlar ek alanlar içerebilir.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "completed",
  "task_created_at": 1788652800,
  "billing_status": "charged",
  "credits": 50,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Görev başarısız oldu: Başarısızlık geri arama yükü

Oluşturma işlemi başarısız olduğunda, geri arama status=failed değerini döndürür. Görevi tanımlamak için id, başarısızlık nedenini görmek için failed_reason ve iade edilen kredi miktarını öğrenmek için credits_refunded parametrelerini kullanın.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652848,
  "model": "seedance-2-5-flash",
  "status": "failed",
  "task_created_at": 1788652800,
  "billing_status": "refunded",
  "credits": 50,
  "failed_reason": "provider_failed",
  "credits_refunded": 50
}

Alıcı örneği

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

Bu Next.js örneği, JSON geri arama gövdesini okur ve tamamlanan ya da başarısız olan görevleri doğrudan işler. Kendi uygulamanız için veri kalıcılığı ve görev kimliği (task-ID) tekilleştirme özellikleri ekleyin; geri aramayı onaylamadan önce yavaş çalışan işlemleri sıraya alın.

Medya gereksinimleri ve sınırlamaları

  • Tüm medya ve geri çağırma URL'leri genel erişime açık HTTPS URL'leri olmalıdır. Localhost, özel IP'ler ve çerez veya oturum açma gerektiren dosyalardan kaçının. Referans video/ses URL'leri doğrudan okunabilir medyaya yönlenmelidir.
  • reference-to-video modunda, toplamda 30 görsel, 10 video, 10 ses dosyası ve 50 materyal sınırını aşmayacak şekilde en az bir referans sağlayın. Toplam video süresi ve toplam ses süresinin her biri en fazla 30 saniye olmalıdır.
  • text-to-video tüm medya referanslarını yoksayar. image-to-video yalnızca ilk/son kare görsellerini iletir ve video ile ses referanslarını yoksayar. Medyaları birleştirmek için reference-to-video modunu kullanın.
  • Her bir referans video ve ses dosyası 2-30 saniye arasında olmalıdır. Video düzenleme örnekleri için en az 4 saniyelik kaynak klipler kullanın.

Görsel gereksinimleri

  • Her bir görselin boyutu 30 MB'tan küçük olmalıdır.
  • Desteklenen biçimler: jpeg, png, webp, bmp, tiff, gif.
  • En boy oranı (genişlik ÷ yükseklik): 0,4 ile 2,5 arasında (sınırlar dahil) olmalıdır.
  • Genişlik ve yüksekliğin her biri 300 ile 6.000 piksel arasında (sınırlar dahil) olmalıdır.

Video gereksinimleri

  • Desteklenen biçimler: mp4, mov.
  • Her bir videonun boyutu 100 MB'ı aşmamalıdır.
  • Kare hızı: 24 ile 60 FPS arasında (sınırlar dahil) olmalıdır.
  • En boy oranı (genişlik ÷ yükseklik): 0,4 ile 2,5 arasında (sınırlar dahil) olmalıdır.
  • Toplam piksel sayısı (genişlik × yükseklik): 407.696 ile 8.295.044 arasında (sınırlar dahil) olmalıdır. Örneğin, 614 × 664 = 407.696 ve 3.326 × 2.494 = 8.295.044. Bunlar piksel sayısına ilişkin örneklerdir; sabit genişlik ve yükseklik gereksinimleri değildir.

Ses gereksinimleri

  • Desteklenen biçimler: wav, mp3.
  • Her bir ses dosyasının boyutu 15 MB'ı aşmamalıdır.