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
}

Taslak önizleme → 1080p final

Seedance 2.5 iki adımlı bir iş akışını destekler: Önce görselleri ve hareketi kontrol etmek için 480p bir Taslak (Draft) üretin, ardından bunu 1080p nihai (final) video oluşturmak için yeniden kullanın. Her iki adım da POST /v1/videos/generations uç noktasını kullanır ve ayrı ayrı ücretlendirilen bağımsız görevler oluşturur.

Taslak modu, farklı fikirleri deneme maliyetini azaltabilir. Her denemeyi doğrudan 1080p olarak üretmek yerine, daha düşük maliyetli birkaç adet 480p Taslak oluşturabilir, en beğendiğinizi seçip ardından bu Taslağı kullanarak 1080p nihai videoyu üretebilirsiniz. Bu sayede, yüksek çözünürlüklü sürüm için ödeme yapmadan önce farklı sonuçları daha düşük bir maliyetle keşfedebilirsiniz.

1. 480p Taslak üretin

input.draft=true değerini ayarlayın ve her zamanki istemi, referansları ve üretim ayarlarını sağlayın. Taslak modunda çözünürlük varsayılan olarak 480p olur; diğer çözünürlükler reddedilir. Aşağıda gösterildiği gibi Taslak için return_last_frame özelliğini etkinleştirebilirsiniz.

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",
    "draft": true,
    "duration": 5,
    "resolution": "480p",
    "return_last_frame": true
  }
}'

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

2. Taslağın tamamlanmasını bekleyin

İstek oluşturma yanıtındaki taskId değerini kaydedin ve durum completed olana kadar GET /v1/tasks/TASK_ID sorgusunu çalıştırın. Sorgu yanıtında is_draft=true yer alır; videoyu data.results alanından önizleyebilirsiniz. Talep edildiyse, hazır olan son kare data.last_frame_url içinde bulunur.

Taslak tamamlandığında bir Webhook bildirimi de alabilirsiniz. Taslak oluşturma isteğinin en üst düzeyinde callback_url parametresini ayarlamanız yeterlidir. Taslak tamamlandığında bu URL'ye bir bildirim gönderilir; böylece servisiniz geri çağırmayı işleyerek sonucu kaydedebilir, görev durumunu güncelleyebilir veya kendi iş akışlarınızı tetikleyebilir. Geri çağırma formatı için bu sayfadaki Webhook'lar bölümüne bakın.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "is_draft": true,
  "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": "https://cdn.seevio.ai/api/images/draft-last-frame.jpg",
    "processing_time": 48
  }
}

3. 1080p final üretin

Bu örnekteki draft_task_id değerini tamamlanmış Taslağınızın taskId değeriyle değiştirin. Final videosu, Taslağın içeriğini ve süresini devralır. Çözünürlük varsayılan olarak 1080p olur ve başka bir çözünürlük kabul edilmez. output_format, watermark ve return_last_frame ayarları her final videosu için bağımsız olarak belirlenebilir; callback_url ise yine isteğin en üst düzeyinde yer alır.

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": {
    "draft_task_id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
    "resolution": "1080p",
    "output_format": "mp4",
    "watermark": false,
    "return_last_frame": true
  }
}'

Yanıt, nihai video için yeni bir taskId içerir. Bu yeni kimliği sorgulayın veya webhook bildirimini bekleyin. Final videosunun sorgu yanıtında is_draft=false olur ve draft_task_id değeri orijinal Taslağın API görev kimliğine eşit olur. Orijinal Taslak geçerliliğini korur. Kabul edilen her final isteği, ayrı ücretlendirilen yeni bir görev oluşturur.

{
  "taskId": "final_7mQx2pN8kR4vT9cL6bW3",
  "credits": 150
}

Taslak ve final ücretlendirmesi

Taslaklar, geçerli olduğunda referans video girdisi de dahil olmak üzere yukarıdaki 480p ücretleri üzerinden değerlendirilir. Finaller ise saniye başına 30 kredi olan 1080p yalnızca çıktı ücretiyle ücretlendirilir; referans video girdisi için tekrar ücret alınmaz. Örneğin, referans videosu olmayan 5 saniyelik bir Taslak 50 krediye, 5 saniyelik bir final ise ek olarak 150 krediye mal olur.

duration=-1 olduğunda, Taslak ve finalin her biri en fazla 30 saniyelik çıktı süresi için kredi rezerve eder; referans video girdisi ise yalnızca Taslak için rezerve edilir. İşlem tamamlandığında, ücret belirlenebilen gerçek çıktı süresine göre ayarlanır ve kullanılmayan rezerve krediler iade edilir. Bir final isteği en fazla 900 kredi rezerve eder.

Ü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",
  "is_draft": false,
  "draft_task_id": null,
  "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",
  "is_draft": false,
  "draft_task_id": null,
  "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"
}'

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",
  "status": "completed",
  "task_created_at": 1788652800,
  "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
  }
}

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",
  "status": "failed",
  "task_created_at": 1788652800,
  "billing_status": "refunded",
  "credits": 100,
  "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;
    // 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.