Docs Rivya AI
Trang API mô hình

Tích hợp API Seedance 1.0 Lite

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

Khả dụng qua APIText hoặc URL sẵn sàng; reference modes dùng Files APIVideo
ID mô hình API

seedance-1-0-lite

Input

text, file

Files API

Bắt buộc cho reference modes

Tín dụng cơ bản

16

Năng lực

Video

Thanh toán

FIXED

Giới hạn prompt

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

KeyTypeBắt buộcDefaultMô tả
modelstringseedance-1-0-liteDùng API model id seedance-1-0-lite.
promptstring-Tối đa 10000 ký tự cho mô hình này.
paramsobjectKhô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_idstringKhông-Client-side id tùy chọn để trace request trong hệ thống của bạn.

Tham số mô hình

KeyTypeBắt buộcDefaultRangeOptionsMô tả
resolutionselectKhông720p-480p, 720p, 1080pĐộ phân giải
durationselectKhông5-5, 10Thời lượng
aspect_ratioselectKhông16:9-16:9, 4:3, 1:1, 3:4, 9:16, 9:21Tỷ lệ khung hình
camera_fixedselectKhôngfalse-false, trueKiể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.
seednumberKhông-1min -1 / max 2147483647-Để trống để mỗi lần nhận một kết quả ngẫu nhiên mới. Dùng lại cùng một số nguyên sẽ giúp dễ tái tạo hoặc tinh chỉnh kết quả trước đó hơn. Kết quả chỉ gần hơn khi prompt và các thiết lập quan trọng khác cũng tương tự, và không đảm bảo khớp 1:1.
enable_safety_checkerselectKhôngtrue-true, falseKiểm tra an toà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.

Quy tắc tham chiếu

Ảnh tham chiếu: Upload 1 ảnh nguồn cho image-to-video, hoặc 2 ảnh khi bạn cũng muốn cung cấp một khung cuối tùy chọn.

Số file tối đa

2

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

image

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

kindKích thước tối đaMIME types
image10 MBimage/jpeg, image/png, image/webp

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

{
  "model": "seedance-1-0-lite",
  "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"
  }
}

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

{
  "model": "seedance-1-0-lite",
  "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"
      }
    ]
  }
}

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_0_lite_example",
  "status": "queued",
  "model": "seedance-1-0-lite",
  "reserved_credits": 16,
  "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.