Integrasi API Seedance 1.0 Pro
Gunakan Seedance 1.0 Pro melalui Rivya Public API v1 dengan ID model seedance-1-0-pro, input disokong, parameter, peraturan Files API, kredit dan contoh respons.
seedance-1-0-pro
text, file
Diperlukan untuk mod rujukan
25
Video
FIXED
10000 aksara
Kontrak permintaan
Hantar ID model pada peringkat atas. Kawalan khusus model berada dalam params.
| Kunci | Jenis | Wajib | Lalai | Penerangan |
|---|---|---|---|---|
| model | string | Ya | seedance-1-0-pro | Gunakan ID model API seedance-1-0-pro. |
| prompt | string | Ya | - | Maksimum 10000 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 |
|---|---|---|---|---|---|---|
| resolution | select | Tidak | 720p | - | 480p, 720p, 1080p | Resolusi |
| duration | select | Tidak | 5 | - | 5, 10 | Tempoh |
| aspect_ratio | select | Tidak | 16:9 | - | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Nisbah aspek |
| camera_fixed | select | Tidak | false | - | false, true | Mengawal sama ada shot patut berkelakuan lebih seperti kamera tetap. Menghidupkannya mengekalkan gerakan kamera lebih terkawal; mematikannya membenarkan gerakan yang lebih jelas. |
| seed | number | Tidak | -1 | min -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_checker | select | Tidak | true | - | true, false | Pemeriksa keselamatan |
Polisi muat naik
Muat naik fail rujukan dahulu, kemudian letakkan URL dan token durasi yang dikembalikan dalam params.referenceMediaItems.
Imej rujukan: Muat naik 1 fail imej untuk larian imej-ke-video.
1
image
Rujukan video dan audio patut membawa durationToken daripada /api/v1/files apabila pengesahan durasi diperlukan.
| kind | Saiz maksimum | Jenis MIME |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Permintaan minimum
{
"model": "seedance-1-0-pro",
"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-pro",
"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_pro_example",
"status": "queued",
"model": "seedance-1-0-pro",
"reserved_credits": 25,
"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.