Docs Rivya AI
Halaman API model

Integrasi API Seedance 1.0 Lite

Gunakan Seedance 1.0 Lite melalui Rivya Public API v1 dengan ID model seedance-1-0-lite, 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-1-0-lite

Input

text, file

Files API

Diperlukan untuk mod rujukan

Kredit asas

16

Keupayaan

Video

Bil

FIXED

Had prompt

10000 aksara

Kontrak permintaan

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

KunciJenisWajibLalaiPenerangan
modelstringYaseedance-1-0-liteGunakan ID model API seedance-1-0-lite.
promptstringYa-Maksimum 10000 aksara untuk model ini.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk kunci yang dibenarkan.
client_request_idstringTidak-ID sisi klien pilihan untuk menjejak permintaan dalam sistem anda.

Parameter model

KunciJenisWajibLalaiJulatPilihanPenerangan
resolutionselectTidak720p-480p, 720p, 1080pResolusi
durationselectTidak5-5, 10Tempoh
aspect_ratioselectTidak16:9-16:9, 4:3, 1:1, 3:4, 9:16, 9:21Nisbah aspek
camera_fixedselectTidakfalse-false, trueMengawal sama ada shot patut berkelakuan lebih seperti kamera tetap. Menghidupkannya mengekalkan gerakan kamera lebih terkawal; mematikannya membenarkan gerakan yang lebih jelas.
seednumberTidak-1min -1 / max 2147483647-Biarkan kosong untuk hasil rawak baharu setiap kali. Menggunakan semula nombor bulat yang sama memudahkan anda menghasilkan semula atau memperhalus hasil sebelumnya. Hasil hanya kekal lebih hampir apabila prompt dan tetapan utama lain juga masih serupa, dan ia bukan padanan 1:1 yang dijamin.
enable_safety_checkerselectTidaktrue-true, falsePemeriksa keselamatan

Polisi muat naik

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

Peraturan rujukan

Imej rujukan: Muat naik 1 imej sumber untuk imej-ke-video, atau 2 imej apabila anda juga mahu menyediakan bingkai akhir pilihan.

Fail maksimum

2

Jenis fail diterima

image

Token durasi

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

kindSaiz maksimumJenis MIME
image10 MBimage/jpeg, image/png, image/webp

Permintaan minimum

{
  "model": "seedance-1-0-lite",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

Permintaan fail rujukan

{
  "model": "seedance-1-0-lite",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Respons cipta

Endpoint cipta mengembalikan ID tugasan awam. Poll endpoint status sehingga tugasan berjaya atau gagal.

{
  "id": "task_seedance_1_0_lite_example",
  "status": "queued",
  "model": "seedance-1-0-lite",
  "reserved_credits": 16,
  "final_credits": 0,
  "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.