/v1/asset.
Trang này giải thích thư viện hoạt động như thế nào và cầ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
Activemới có thể được tham chiếu trong việc tạo video.
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 cho | Nhân vật hư cấu / AI, đạo cụ, cảnh | Hình ảnh của một người thật |
| Được tạo bởi | Một lệnh gọi tạo trực tiếp | Một lần xác minh khuôn mặt bởi chính người đó |
| Lý do | Khô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ạng | Ràng buộc |
|---|---|---|
| Hình ảnh | jpeg, png, webp, bmp, tiff, gif, heic/heif | tỷ lệ khung hình (W/H) 0.4–2.5 · 300–6000 px mỗi cạnh · < 30 MB |
| Video | mp4, mov | 480p/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 thanh | wav, mp3 | 2–15 s · ≤ 15 MB |
- 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.
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ộtasset_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: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.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.
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.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ới403.
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áiActive, 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ô:
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.
