Dùng Seedance 2.0 qua Rivya Public API v1 với model id seedance-2, input được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ response.

Khả dụng qua APIText input sẵn sàngVideo

ID mô hình API

seedance-2

Input

text

Files API

Không bắt buộc cho minimal request

Tín dụng cơ bản

175

Năng lực

Video

Thanh toán

FIXED

Giới hạn prompt

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-2	Dùng API model id seedance-2.
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ả
seedance_scene	select	Không	text	-	text, frames, reference	Chọn đường Seedance 2 cần chạy: text-to-video thuần, dẫn hướng bằng khung đầu / khung đầu-cuối, hoặc tạo bằng tham chiếu đa phương thức.
resolution	select	Không	720p	-	480p, 720p	Độ phân giải
aspect_ratio	select	Không	16:9	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Tỷ lệ khung hình
duration	number	Không	5	min 4 / max 15	-	Thời lượng
generate_audio	select	Không	true	-	true, false	Tạo âm thanh
return_last_frame	select	Không	false	-	false, true	Cũng trả về khung cuối dưới dạng ảnh tĩnh, hữu ích cho ảnh bìa, lượt chạy tiếp theo hoặc chỉnh sửa sau.
web_search	select	Không	false	-	false, true	Tìm kiếm web
nsfw_checker	select	Không	false	-	false, true	Trình kiểm tra NSFW

Yêu cầu tối thiểu

{
  "model": "seedance-2",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "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"
  }
}

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_2_example",
  "status": "queued",
  "model": "seedance-2",
  "reserved_credits": 175,
  "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