Seedance 2.5 modelini Rivya Public API v1 üzerinden model id seedance-2-5, desteklenen girişler, parametreler, Files API kuralları, krediler ve yanıt örnekleriyle kullanın.

API üzerinden kullanılabilirMetin veya URL hazır; referans modları Files API kullanırVideo

API model kimliği

seedance-2-5

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

per_input_and_output_second · 480p_with_video=17 · 480p_without_video=28 · 720p_with_video=38 · 720p_without_video=63 · 1080p_with_video=68.5 · 1080p_without_video=114 · ⌈total⌉

Yetenek

Video

Faturalandırma

METERED

Prompt limiti

30000 karakter

İstek sözleşmesi

Model id değerini en üst seviyede gönderin. Modele özel kontroller params içine aittir.

Anahtar	Tür	Gerekli	Varsayılan	Açıklama
model	string	Evet	seedance-2-5	seedance-2-5 API model kimliği değerini kullanın.
prompt	string	Hayır	-	Bu model için en fazla 30000 karakter.
params	object	Hayır	-	Modele özel parametre nesnesi. İzin verilen anahtarlar için aşağıdaki satırları kullanın.
client_request_id	string	Hayır	-	Sisteminizde istekleri izlemek için isteğe bağlı istemci tarafı id.

Model parametreleri

Anahtar	Tür	Gerekli	Varsayılan	Aralık	Seçenekler	Açıklama
seedance_scene	select	Hayır	text	-	text, frames, reference	Yüklemeden önce giriş sözleşmesini seçin; metin, kare kılavuzu ve referanslar birbirini dışlayan sahnelerdir.
resolution	select	Hayır	720p	-	480p, 720p, 1080p	Her çözünürlükte videosuz ve videolu ayrı oranlar vardır.
aspect_ratio	select	Hayır	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	En-boy oranı
duration	number	Hayır	5	min -1 / max 30 / step 1	-	Otomatik süre için -1 veya 4 ile 30 saniye arasında tam sayı seçin. Otomatik süre, çalışmadan önce 30 çıktı saniyesi ayırır.
output_format	select	Hayır	mp4	-	mp4, mov	Çıktı biçimi
generate_audio	select	Hayır	true	-	true, false	Çıktı klibiyle birlikte üretilmiş ses isteyin.
return_last_frame	select	Hayır	false	-	false, true	İnceleme veya sonraki çalışma için videonun son karesini sabit görüntü olarak da döndürün.
web_search	select	Hayır	false	-	false, true	Modelin bu çalışma için isteğe bağlı web araması kontrolünü kullanmasına izin verin.
nsfw_checker	select	Hayır	true	-	false, true	Modelin isteğe bağlı içerik filtresini etkinleştirin. Hiçbir otomatik filtre tam kapsamı garanti edemez.

Yükleme politikası

Önce referans dosyalarını yükleyin, ardından dönen URLyi ve duration token değerini params.referenceMediaItems içine yerleştirin.

Referans kuralı

Kılavuz kareler veya yüksek kapasiteli referanslar: Kareler sahnesi, her biri en fazla 30 MB olan 1 veya 2 JPEG, PNG, WebP, BMP, GIF ya da TIFF görüntü kabul eder. Referans sahnesi en fazla 30 görüntü, her biri 95 MB ve 2–30 saniye olan 10 MP4/MOV video ve her biri 15 MB ve 2–30 saniye olan 10 MP3/WAV ses dosyası kabul eder; toplam video ve ses süreleri ayrı ayrı 30 saniye, tüm medya birlikte 50 dosyayla sınırlıdır.

Maks. dosya

Kabul edilen dosya türleri

image, video, audio

Süre belirteci

Süre doğrulaması gerektiğinde video ve ses referansları /api/v1/files içinden durationToken taşımalıdır.

kind	Maks. boyut	MIME türleri
image	30 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Minimal istek

{
  "model": "seedance-2-5",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

Referans dosyalı istek

{
  "model": "seedance-2-5",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Create yanıtı

Create endpointi herkese açık task id döndürür. Görev başarılı veya başarısız olana kadar status endpointini sorgulayın.

{
  "id": "task_seedance_2_5_example",
  "status": "queued",
  "model": "seedance-2-5",
  "reserved_credits": 315,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Yaygın hatalar

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Bazı modlar Files API referans yüklemeleri gerektirir.

Seedance 2.5 API Entegrasyonu