Chuyển đến nội dung chính
Seedance 2.0 tạo video từ tài nguyên tham chiếu đáng tin cậy — một khuôn mặt, một bộ trang phục, một sản phẩm, một giọng nói. Để giữ cho việc tạo nhất quán và tuân thủ, các tham chiếu đó được lưu trong một thư viện tài nguyên riêng tư mà mô hình tin cậy tại thời điểm suy luận. OrcaRouter cung cấp thư viện đó qua /v1/asset. Trang này giải thích thư viện hoạt động như thế nàocần những gì. Về các endpoint cụ thể, tham số, và bảng điều khiển dùng thử, xem API Reference → Seedance Assets.

Cấu trúc của thư viện

  • Asset Group (Nhóm tài nguyên) — một bộ chứa. Với nhóm người thật, một nhóm tương ứng với một người thật; với nhóm ảo, đó là một nhóm logic (ví dụ một nhân vật).
  • Asset (Tài nguyên) — một tệp đơn (hình ảnh, video, hoặc âm thanh) bên trong một nhóm. Chỉ những tài nguyên đạt trạng thái Active mới có thể được tham chiếu trong việc tạo video.
Bạn tham chiếu một tài nguyên đã sẵn sàng trong yêu cầu video bằng asset://<asset_id>.

Hai loại nhóm

Các thao tác tải lên và quản lý là giống hệt nhau cho cả hai; chúng chỉ khác nhau ở cách nhóm được tạo.
Ảo (AIGC)Người thật (LivenessFace)
Dùng choNhân vật hư cấu / AI, đạo cụ, cảnhHình ảnh của một người thật
Được tạo bởiMột lệnh gọi tạo trực tiếpMột lần xác minh khuôn mặt bởi chính người đó
Lý doKhông có danh tính cần bảo vệQuyền chân dung — sự đồng ý được thu thập tại nguồn
Cả hai thư viện đều yêu cầu Advanced Creation Rights; hạn ngạch dung lượng được chia sẻ giữa chúng. Thư viện người thật chỉ dành cho các tài khoản được mời.

Yêu cầu về tệp tài nguyên

Tài nguyên được cung cấp dưới dạng một URL có thể truy cập công khai (không tải tệp lên, không base64). Giới hạn:
LoạiĐịnh dạngRàng buộc
Hình ảnhjpeg, png, webp, bmp, tiff, gif, heic/heiftỷ lệ khung hình (W/H) 0.4–2.5 · 300–6000 px mỗi cạnh · < 30 MB
Videomp4, mov480p/720p/1080p · 2–15 s · tỷ lệ 0.4–2.5 · 300–6000 px · tổng số pixel 409,600–2,086,876 · 24–60 fps · ≤ 50 MB
Âm thanhwav, mp32–15 s · ≤ 15 MB
Nội dung chân dung, thực hành tốt nhất (để khuôn mặt nhất quán):
  • Tham chiếu toàn thân: ảnh dọc, chụp chính diện toàn thân của người đó.
  • Cận cảnh khuôn mặt: ảnh dọc, biểu cảm trung tính, đóng khung từ vai trở lên, khuôn mặt chiếm khoảng hai phần ba khung hình.
Tải nhiều tham chiếu tốt của cùng một người vào một nhóm sẽ cải thiện độ trung thực mà video được tạo tái tạo khuôn mặt và trang phục của họ.

Vòng đời tài nguyên (tải lên là bất đồng bộ)

Tải lên một tài nguyên sẽ trả về ngay lập tức với một asset_id; tệp sau đó được tiền xử lý ở chế độ nền. Hãy thăm dò tài nguyên cho đến khi Status của nó ổn định:
  • Processing — vẫn đang tiền xử lý; tiếp tục thăm dò.
  • Active — đã sẵn sàng; dùng nó trong việc tạo video.
  • Failed — tiền xử lý đã từ chối nó; kiểm tra Error (ví dụ định dạng/kích thước, bị chặn bởi kiểm duyệt nội dung, hoặc — với nhóm người thật — FaceMismatch).
SLA về thời gian tải lên không được đảm bảo; tài nguyên video mất nhiều thời gian hơn hình ảnh. URL tải xuống đã ký được trả về cho một tài nguyên là tạm thời (~12 giờ).

Quy trình xác minh người thật

Một nhóm người thật được tạo bởi việc chính người đó tự xác minh một lần. Backend của bạn không bao giờ xử lý dữ liệu khuôn mặt của họ — nó chỉ điều phối quy trình:
1

Bắt đầu một phiên

Backend của bạn yêu cầu OrcaRouter bắt đầu một phiên xác minh. Bạn nhận lại một liên kết H5 (một trang kiểm tra khuôn mặt được lưu trữ) và một session_id.
2

Người đó xác minh

Bạn đưa liên kết H5 cho người dùng cuối. Họ mở nó trên thiết bị của riêng mình — không cần đăng nhập OrcaRouter — và hoàn thành việc kiểm tra khuôn mặt. Họ ủy quyền một lần; sau đó, các tạo hình mới cho cùng một người có thể được thêm vào cùng một nhóm mà không cần xác minh lại.
3

Nhóm được tạo

Khi thành công, trang xác minh chuyển hướng trình duyệt của người dùng cuối trở lại một callback của OrcaRouter (được xử lý tự động), và nhóm mới được đăng ký cho bạn. Nếu bạn đã truyền một return_url, người dùng sẽ quay lại trang của bạn.
4

Thăm dò kết quả

Backend của bạn thăm dò phiên cho đến khi statussuccess (với group_id mới) hoặc failed. Sau đó bạn tải tài nguyên lên và tạo video y hệt như một nhóm ảo.
Khuôn mặt nhất quán. Khi bạn tải một hình ảnh lên một nhóm người thật, nó được so sánh với tham chiếu đã xác minh. Một người khác (hoặc nhiều khuôn mặt trong một hình ảnh) sẽ bị từ chối — tài nguyên chuyển thành Failed / FaceMismatch. Tên và mô tả của một nhóm có thể được đặt sau khi tạo qua thao tác cập nhật nhóm.

Hạn ngạch

Tài khoản của bạn có số lượng tài nguyên tối đa (mặc định 100, trên tất cả các nhóm). Các lượt tải lên vượt quá giới hạn bị từ chối với 403.

Tham chiếu một tài nguyên trong việc tạo video

Khi một tài nguyên ở trạng thái Active, hãy tham chiếu nó bằng asset://<asset_id> trong metadata.content[] của yêu cầu video Seedance, và trỏ tới nó trong prompt theo loại + vị trí ([Image 1], [Video 1], [Audio 1]) — không bao giờ dùng asset id thô:
{
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "prompt": "The girl in [Image 1] arranges items on the counter.",
  "metadata": {
    "content": [
      { "type": "image_url", "role": "reference_image",
        "image_url": { "url": "asset://asset-20260318071009-xy98z" } }
    ]
  }
}

Tiếp theo

  • API Reference → Seedance Assets — mọi endpoint, tham số đầy đủ, và một sân chơi tương tác (đây là nơi chứa các mẫu request/response).
  • Seedance Video — endpoint tạo video tiêu thụ các tài nguyên này.