Gunakan Seedance 2.5 melalui Rivya Public API v1 dengan id model seedance-2-5, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APITeks atau URL siap; mode referensi memakai Files APIVideo

ID model API

seedance-2-5

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

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⌉

Kapabilitas

Video

Tagihan

METERED

Batas prompt

30000 karakter

Kontrak request

Kirim id model di level atas. Kontrol khusus model berada di params.

Key	Tipe	Wajib	Default	Deskripsi
model	string	Ya	seedance-2-5	Gunakan seedance-2-5 sebagai id model API.
prompt	string	Tidak	-	Maksimum 30000 karakter untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_id	string	Tidak	-	ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

Key	Tipe	Wajib	Default	Rentang	Opsi	Deskripsi
seedance_scene	select	Tidak	text	-	text, frames, reference	Pilih kontrak input sebelum mengunggah; teks, panduan bingkai, dan referensi adalah skenario yang saling eksklusif.
resolution	select	Tidak	720p	-	480p, 720p, 1080p	Setiap resolusi memiliki tarif tanpa-video dan dengan-video tersendiri.
aspect_ratio	select	Tidak	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Rasio aspek
duration	number	Tidak	5	min -1 / max 30 / step 1	-	Pilih -1 untuk durasi otomatis atau bilangan bulat 4 hingga 30 detik. Durasi otomatis mencadangkan 30 detik output sebelum proses.
output_format	select	Tidak	mp4	-	mp4, mov	Format output
generate_audio	select	Tidak	true	-	true, false	Minta audio buatan model bersama klip output.
return_last_frame	select	Tidak	false	-	false, true	Kembalikan juga bingkai video terakhir sebagai gambar diam untuk ditinjau atau dipakai selanjutnya.
web_search	select	Tidak	false	-	false, true	Izinkan model memakai kontrol pencarian web opsional untuk proses ini.
nsfw_checker	select	Tidak	true	-	false, true	Aktifkan filter konten opsional model. Tidak ada filter otomatis yang dapat menjamin cakupan lengkap.

Kebijakan unggahan

Unggah file referensi terlebih dahulu, lalu tempatkan URL dan duration token yang dikembalikan ke dalam params.referenceMediaItems.

Aturan referensi

Bingkai panduan atau referensi berkapasitas tinggi: Bingkai menerima 1 atau 2 gambar JPEG, PNG, WebP, BMP, GIF, atau TIFF hingga 30 MB per gambar. Referensi menerima hingga 30 gambar, 10 video MP4/MOV hingga 95 MB dan 2-30 detik per video, serta 10 berkas audio MP3/WAV hingga 15 MB dan 2-30 detik per berkas; total video dan audio masing-masing dibatasi 30 detik dan semua media dibatasi 50 berkas.

File maksimum

Jenis file yang diterima

image, video, audio

Duration token

Referensi video dan audio harus membawa durationToken dari /api/v1/files saat verifikasi durasi diperlukan.

kind	Ukuran maksimum	Tipe MIME
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

Request minimal

{
  "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"
  }
}

Request file referensi

{
  "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"
      }
    ]
  }
}

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.

{
  "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
}

Error umum

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Beberapa mode membutuhkan unggahan referensi Files API.

Integrasi API Seedance 2.5