Seedance 2.5

Yetenekler

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.

• 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.

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.

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.

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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "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": 100
}

Görev oluştur

Model ve input bilgilerinin yanı sıra isteğe bağlı bir callback_url içeren bir JSON nesnesi gönderin. Her zaman bu sayfada gösterilen model kimliğini belirtin; model alanının boş bırakılması seedance-2-0 modelini seçer.

İstek gövdesi

Giriş parametreleri

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.

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": 100
}

Üretim modları ve örnekler

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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

Video düzenleme

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",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Video uzatma

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",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Görev sorgula

Ö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"

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",
  "status": "completed",
  "billing_status": "charged",
  "credits": 100,
  "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",
  "status": "failed",
  "billing_status": "refunded",
  "credits": 100,
  "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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Webhook verileri, görev sorgulama yanıtlarından farklıdır: billing_status ve credits alanlarını içermezler; başarısızlık detayları data.failed_reason ve data.credits_refunded içinde yer alır. Webhook created_at değeri, Unix saniyesi cinsinden olayın oluşturulma zamanıdır.

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.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "completed",
  "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 data.failed_reason ve iade edilen kredi miktarını öğrenmek için data.credits_refunded parametrelerini kullanın.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "failed",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 100
  }
}

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.data;
    // 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.

Hatalar

HTTP hataları, code ve message içeren bir error nesnesine sahiptir. Başarıyla kabul edilen bir görev daha sonra yine de başarısız olabilir; görevi sorgulayın veya başarısızlık geri çağırmasını işleyin.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

İstek sınırları

Görev oluşturma: Her bir API anahtarı, varsayılan olarak dakikada en fazla 100 isteğe izin verir. Özel istek limitleri şu anda desteklenmemektedir.

Görev sorgulama: Her bir API anahtarı, varsayılan olarak dakikada en fazla 120 isteğe izin verir. Sorgulama istekleri ve görev oluşturma istekleri birbirinden bağımsız olarak sayılır.