Dùng Seedance 2.5 qua Rivya Public API v1 với ID mô hình seedance-2-5, đầu vào được hỗ trợ, tham số, quy tắc Files API, tín dụng và ví dụ phản hồi.

Khả dụng qua APIVăn bản hoặc URL đã sẵn sàng; chế độ tham chiếu dùng Files APIVideo

ID mô hình API

seedance-2-5

Đầu vào

text, file

Files API

Bắt buộc cho chế độ tham chiếu

Tín dụng cơ bản

per_input_and_output_second · 480p_with_video=17 · 480p_without_video=28 · 720p_with_video=38 · 720p_without_video=63 · 1080p_with_video=68.5 · 1080p_without_video=114 · ⌈total⌉

Năng lực

Video

Thanh toán

METERED

Giới hạn prompt

30000 ký tự

Quy ước yêu cầu

Gửi ID mô hình ở cấp trên cùng. Điều khiển riêng của mô hình nằm trong params.

Key	Loại	Bắt buộc	Mặc định	Mô tả
model	string	Có	seedance-2-5	Dùng seedance-2-5 làm ID mô hình API.
prompt	string	Không	-	Tối đa 30000 ký tự cho mô hình này.
params	object	Không	-	Đối tượng 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	-	ID phía client không bắt buộc để theo dõi yêu cầu trong hệ thống của bạn.

Tham số mô hình

Key	Loại	Bắt buộc	Mặc định	Phạm vi	Tùy chọn	Mô tả
seedance_scene	select	Không	text	-	text, frames, reference	Chọn hợp đồng đầu vào trước khi tải tệp lên; văn bản, hướng dẫn bằng khung hình và tham chiếu là các cảnh loại trừ lẫn nhau.
resolution	select	Không	720p	-	480p, 720p, 1080p	Mỗi độ phân giải có mức không-video và có-video riêng.
aspect_ratio	select	Không	adaptive	-	1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive	Tỷ lệ khung hình
duration	number	Không	5	min -1 / max 30 / step 1	-	Chọn -1 cho thời lượng tự động hoặc số nguyên từ 4 đến 30 giây. Thời lượng tự động tạm giữ 30 giây đầu ra trước khi chạy.
output_format	select	Không	mp4	-	mp4, mov	Định dạng đầu ra
generate_audio	select	Không	true	-	true, false	Yêu cầu tạo âm thanh cùng clip đầu ra.
return_last_frame	select	Không	false	-	false, true	Cũng trả về khung cuối của video dưới dạng ảnh tĩnh để xem lại hoặc tiếp tục công việc.
web_search	select	Không	false	-	false, true	Cho phép mô hình dùng điều khiển tìm kiếm web tùy chọn trong lượt chạy này.
nsfw_checker	select	Không	true	-	false, true	Bật bộ lọc nội dung tùy chọn của mô hình. Không bộ lọc tự động nào có thể bảo đảm bao phủ hoàn toàn.

Chính sách tải lên

Trước tiên tải tệp tham chiếu lên, rồi đặt URL và duration token được trả về vào params.referenceMediaItems.

Quy tắc tham chiếu

Khung hướng dẫn hoặc tham chiếu dung lượng cao: Cảnh khung hình chấp nhận 1 hoặc 2 ảnh JPEG, PNG, WebP, BMP, GIF hoặc TIFF tối đa 30 MB mỗi tệp. Cảnh tham chiếu chấp nhận tối đa 30 ảnh, 10 video MP4/MOV tối đa 95 MB và 2-30 giây mỗi tệp, cùng 10 tệp âm thanh MP3/WAV tối đa 15 MB và 2-30 giây mỗi tệp; tổng thời lượng video và âm thanh đều được giới hạn riêng ở 30 giây, còn toàn bộ media được giới hạn ở 50 tệp.

Số tệp tối đa

Loại tệp được chấp nhận

image, video, audio

Token thời lượng

Tham chiếu video và audio nên mang durationToken từ /api/v1/files khi cần xác minh thời lượng.

kind	Kích thước tối đa	Loại MIME
image	30 MB	image/jpeg, image/png, image/webp, image/bmp, image/gif, image/tiff
video	95 MB	video/mp4, video/quicktime
audio	15 MB	audio/mpeg, audio/wav, audio/x-wav

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

{
  "model": "seedance-2-5",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "text",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true"
  }
}

Yêu cầu có tệp tham chiếu

{
  "model": "seedance-2-5",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "seedance_scene": "reference",
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4",
    "generate_audio": "true",
    "return_last_frame": "false",
    "web_search": "false",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-video.mp4",
        "kind": "video",
        "name": "reference-video.mp4",
        "mimeType": "video/mp4",
        "durationSeconds": 8,
        "durationToken": "video_duration_token_from_files_api",
        "width": 1280,
        "height": 720,
        "sizeBytes": 8388608,
        "framesPerSecond": 30,
        "videoBitrateMbps": 8,
        "videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Phản hồi tạo

Điểm cuối tạo trả về ID tác vụ công khai. Hãy thăm dò điểm cuối trạng thái cho đến khi tác vụ succeeded hoặc failed.

{
  "id": "task_seedance_2_5_example",
  "status": "queued",
  "model": "seedance-2-5",
  "reserved_credits": 315,
  "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
}

Lỗi thường gặp

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Một số chế độ cần tải tệp tham chiếu qua Files API.

Tích hợp API Seedance 2.5