↓
Docs Rivya AI
Halaman API Model

Integrasi API Seedance 2.0 Fast

Gunakan Seedance 2.0 Fast melalui Rivya Public API v1 dengan id model seedance-2-fast, 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-fast

Input

text, file

Files API

Diperlukan untuk mode referensi

Kredit dasar

Tarif kredit: 6,8–24,8 / detik durasi video total (masukan + keluaran) Biaya akhir tugas dibulatkan ke atas ke kredit utuh.

Kapabilitas

Video

Tagihan

METERED

Batas prompt

20000 karakter

Kontrak request

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

KeyTipeWajibDefaultDeskripsi
modelstringYaseedance-2-fastGunakan seedance-2-fast sebagai id model API.
promptstringYa-Maksimum 20000 karakter untuk model ini.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_idstringTidak-ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

KeyTipeWajibDefaultRentangOpsiDeskripsi
seedance_sceneselectTidaktext-text, frames, referenceMemilih jalur Seedance 2 yang dijalankan: teks-ke-video murni, panduan frame pertama / frame pertama-terakhir, atau pembuatan referensi multimodal.
resolutionselectTidak720p-480p, 720pResolusi
aspect_ratioselectTidak16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptiveRasio aspek
durationnumberTidak5min 4 / max 15-Durasi
generate_audioselectTidaktrue-true, falseBuat audio
return_last_frameselectTidakfalse-false, trueJuga mengembalikan frame akhir sebagai gambar diam, berguna untuk cover, proses lanjutan, atau pengeditan berikutnya.
web_searchselectTidakfalse-false, truePencarian web
nsfw_checkerselectTidakfalse-false, truePemeriksa NSFW

Kebijakan unggahan

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

Aturan referensi

Referensi multimodal: 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.

File maksimum

15

Jenis file yang diterima

image, video, audio

Duration token

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

kindUkuran maksimumTipe MIME
image30 MBimage/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff
video50 MBvideo/mp4, video/quicktime
audio15 MBaudio/mpeg, audio/wav, audio/x-wav

Request minimal

{
  "model": "seedance-2-fast",
  "prompt": "Kamera perlahan mengitari botol produk di atas meja studio.",
  "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"
  }
}

Request file referensi

{
  "model": "seedance-2-fast",
  "prompt": "Kamera perlahan mengitari botol produk di atas meja studio.",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "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
      }
    ]
  }
}

Response create

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

{
  "id": "task_seedance_2_fast_example",
  "status": "queued",
  "model": "seedance-2-fast",
  "reserved_credits": 124,
  "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.