Gunakan Seedance 2.5 melalui Rivya Public API v1 dengan ID model seedance-2-5, input disokong, parameter, peraturan Files API, kredit dan contoh respons.

Tersedia melalui APITeks atau URL sedia; mod rujukan menggunakan Files APIVideo

ID model API

seedance-2-5

Input

text, file

Files API

Diperlukan untuk mod rujukan

Kredit asas

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⌉

Keupayaan

Video

Bil

METERED

Had prompt

30000 aksara

Kontrak permintaan

Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.

Kunci	Jenis	Wajib	Lalai	Penerangan
model	string	Ya	seedance-2-5	Gunakan ID model API seedance-2-5.
prompt	string	Tidak	-	Maksimum 30000 aksara untuk model ini.
params	object	Tidak	-	Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_id	string	Tidak	-	ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

Kunci	Jenis	Wajib	Lalai	Julat	Pilihan	Penerangan
seedance_scene	select	Tidak	text	-	text, frames, reference	Pilih kontrak input sebelum memuat naik; teks, panduan bingkai dan rujukan ialah adegan yang saling eksklusif.
resolution	select	Tidak	720p	-	480p, 720p, 1080p	Setiap resolusi mempunyai kadar tanpa video dan dengan video yang berasingan.
aspect_ratio	select	Tidak	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Nisbah aspek
duration	number	Tidak	5	min -1 / max 30 / step 1	-	Pilih -1 untuk tempoh automatik atau nombor bulat dari 4 hingga 30 saat. Tempoh automatik merizabkan 30 saat output sebelum larian.
output_format	select	Tidak	mp4	-	mp4, mov	Format output
generate_audio	select	Tidak	true	-	true, false	Minta audio dijana bersama klip output.
return_last_frame	select	Tidak	false	-	false, true	Turut kembalikan bingkai video terakhir sebagai imej pegun untuk semakan atau kerja susulan.
web_search	select	Tidak	false	-	false, true	Benarkan model menggunakan kawalan carian web pilihannya untuk larian ini.
nsfw_checker	select	Tidak	true	-	false, true	Hidupkan penapis kandungan pilihan model. Tiada penapis automatik yang boleh menjamin liputan lengkap.

Polisi muat naik

Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.

Peraturan rujukan

Bingkai panduan atau rujukan berkapasiti tinggi: Bingkai menerima 1 atau 2 imej JPEG, PNG, WebP, BMP, GIF atau TIFF sehingga 30 MB setiap satu. Rujukan menerima sehingga 30 imej, 10 video MP4/MOV sehingga 95 MB dan 2-30 saat setiap satu, serta 10 fail audio MP3/WAV sehingga 15 MB dan 2-30 saat setiap satu; jumlah video dan audio masing-masing dihadkan kepada 30 saat, manakala semua media bersama-sama dihadkan kepada 50 fail.

Fail maksimum

Jenis fail diterima

image, video, audio

Token durasi

Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.

kind	Saiz maksimum	Jenis 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

Permintaan minimum

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

Permintaan fail rujukan

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

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Semak endpoint status sehingga tugasan berjaya 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
}

Ralat biasa

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Sesetengah mod memerlukan muat naik rujukan Files API.

Integrasi API Seedance 2.5