Seedance 2.0 modelini Rivya Public API v1 üzerinden model id seedance-2, 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

Girişler

text, file

Files API

Referans modları için gerekli

Temel krediler

Kredi oranı: 41–208 / toplam video süresinin saniyesi (girdi + çıktı) Görevin son maliyeti tam krediye yukarı yuvarlanır.

Yetenek

Video

Faturalandırma

METERED

Prompt limiti

20000 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	seedance-2 API model kimliği değerini kullanın.
prompt	string	Evet	-	Bu model için en fazla 20000 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	Hangi Seedance 2 yolunun çalıştırılacağını seçer: saf metinden videoya, ilk kare / ilk-son kare rehberliği veya çok modlu referans üretimi.
resolution	select	Hayır	720p	-	720p, 1080p, 4K	Çözünürlük
aspect_ratio	select	Hayır	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	En-boy oranı
duration	number	Hayır	5	min 4 / max 15	-	Süre
generate_audio	select	Hayır	true	-	true, false	Ses oluştur
return_last_frame	select	Hayır	false	-	false, true	Son kareyi ayrıca sabit görsel olarak döndürür; kapaklar, takip çalıştırmaları veya sonraki düzenlemeler için kullanışlıdır.
web_search	select	Hayır	false	-	false, true	Web araması
nsfw_checker	select	Hayır	false	-	false, true	NSFW denetimi

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ı

Çok modlu referans: Frames: 1–2 signed images. Reference: up to 9 JPEG/PNG/WebP/BMP/TIFF/GIF images under 30 MB each, 3 MP4/MOV videos of 2–15 seconds under 50 MB each, and 3 MP3/WAV audio clips of 2–15 seconds under 15 MB each. Video and audio each have a separate 15-second total limit. At 720p, reference inputs may use images or audio but not video; choose 1080p or 4K when including a reference video.

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	50 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

Minimal istek

{
  "model": "seedance-2",
  "prompt": "Kamera, stüdyo masasındaki bir ürün şişesinin etrafında yavaşça döner.",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false"
  }
}

Referans dosyalı istek

{
  "model": "seedance-2",
  "prompt": "Kamera, stüdyo masasındaki bir ürün şişesinin etrafında yavaşça döner.",
  "params": {
    "seedance_scene": "reference",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 5,
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "false",
    "seedance_reference_videos": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "sizeBytes": 8388608,
        "mimeType": "video/mp4"
      }
    ],
    "videoMetadata": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "token": "video_metadata_token_from_files_api",
        "sizeBytes": 8388608
      }
    ]
  }
}

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_example",
  "status": "queued",
  "model": "seedance-2",
  "reserved_credits": 205,
  "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.0 API Entegrasyonu