Tài liệu Rivya AI
Trang API mô hình

Tích hợp API Seedance 2.0

Dùng Seedance 2.0 qua Rivya Public API v1 với ID mô hình seedance-2, đầ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 APIĐầu vào văn bản sẵn sàngVideo
ID mô hình API

seedance-2

Đầu vào

text

Files API

Không bắt buộc cho yêu cầu tối thiểu

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ự

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.

KeyLoạiBắt buộcMặc địnhMô tả
modelstringseedance-2Dùng seedance-2 làm ID mô hình API.
promptstring-Tối đa 2500 ký tự cho mô hình này.
paramsobjectKhô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_idstringKhô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

KeyLoạiBắt buộcMặc địnhPhạm viTùy chọnMô tả
seedance_sceneselectKhôngtext-text, frames, referenceChọ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.
resolutionselectKhông720p-480p, 720pĐộ phân giải
aspect_ratioselectKhông16:9-1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptiveTỷ lệ khung hình
durationnumberKhông5min 4 / max 15-Thời lượng
generate_audioselectKhôngtrue-true, falseTạo âm thanh
return_last_frameselectKhôngfalse-false, trueCũ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_searchselectKhôngfalse-false, trueTìm kiếm web
nsfw_checkerselectKhôngfalse-false, trueTrì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

Đ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_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

Đ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.