Tích hợp API Seedance 1.5 Pro
Dùng Seedance 1.5 Pro qua Rivya Public API v1 với model id seedance-1-5-pro, input được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ response.
seedance-1-5-pro
text, file
Bắt buộc cho reference modes
28
Video
FIXED
2500 ký tự
Hợp đồng yêu cầu
Gửi model id ở top level. Điều khiển riêng của mô hình nằm trong params.
| Key | Type | Bắt buộc | Default | Mô tả |
|---|---|---|---|---|
| model | string | Có | seedance-1-5-pro | Dùng API model id seedance-1-5-pro. |
| prompt | string | Có | - | Tối đa 2500 ký tự cho mô hình này. |
| params | object | Không | - | Object tham số riêng của mô hình. Dùng các dòng bên dưới để xem key được phép. |
| client_request_id | string | Không | - | Client-side id tùy chọn để trace request trong hệ thống của bạn. |
Tham số mô hình
| Key | Type | Bắt buộc | Default | Range | Options | Mô tả |
|---|---|---|---|---|---|---|
| resolution | select | Không | 720p | - | 480p, 720p, 1080p | Độ phân giải |
| duration | select | Không | 8 | - | 4, 8, 12 | Thời lượng |
| generate_audio | select | Không | false | - | false, true | Tạo âm thanh |
| aspectRatio | select | Không | 1:1 | - | 1:1, 4:3, 3:4, 16:9, 9:16, 21:9 | Tỷ lệ khung hình |
| fixed_lens | select | Không | false | - | false, true | Kiểm soát cảnh có nên hoạt động giống camera cố định hơn hay không. Bật lên sẽ giữ chuyển động camera tiết chế hơn; tắt đi cho phép chuyển động rõ hơn. |
Chính sách tải lên
Upload reference files trước, rồi đặt URL và duration token được trả về vào params.referenceMediaItems.
Ảnh tham chiếu: Upload tối đa 2 tệp ảnh cho các dự án hình ảnh.
2
image
Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh duration.
| kind | Kích thước tối đa | MIME types |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
Yêu cầu tối thiểu
{
"model": "seedance-1-5-pro",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "8",
"generate_audio": "false",
"aspectRatio": "1:1",
"fixed_lens": "false"
}
}Yêu cầu có tệp tham chiếu
{
"model": "seedance-1-5-pro",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "8",
"generate_audio": "false",
"aspectRatio": "1:1",
"fixed_lens": "false",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png"
}
]
}
}Phản hồi tạo
Create endpoint trả về public task id. Poll status endpoint cho đến khi task succeeded hoặc failed.
{
"id": "task_seedance_1_5_pro_example",
"status": "queued",
"model": "seedance-1-5-pro",
"reserved_credits": 28,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Lỗi thường gặp
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Một số mode cần Files API reference uploads.