Skip to main content
POST
Nhập một URL nguồn có thể truy cập công khai vào một nhóm vật liệu Seedance. TokenLab lưu trữ vật liệu để sử dụng sau này; hãy sử dụng id tài nguyên vật liệu được trả về để tạo, thay vì sử dụng URL nguồn. Đối với library_type: "aigc_avatar", group_id là tùy chọn; TokenLab sẽ sử dụng hoặc tạo nhóm avatar ảo mặc định của tổ chức. Đối với library_type: "liveness_face", group_id là bắt buộc và phải là nhóm TokenLab được trả về bởi Lấy kết quả xác thực trực quan. TokenLab kiểm tra URL nguồn, loại phương tiện, kích thước tệp và kích thước ảnh đọc được. Việc chấp nhận nhập không có nghĩa tài nguyên đã sẵn sàng: hãy chờ ACTIVE và xem error_message nếu xử lý thất bại. Các điều kiện khác về phương tiện và khuôn mặt được kiểm tra trong quá trình xử lý. Quá trình tạo diễn ra không đồng bộ. Hãy thực hiện poll Lấy tài nguyên vật liệu (Get Material Asset) cho đến khi status là ACTIVE. Đối với các nhóm người thật, một nhóm tương ứng với một người đã được xác minh; việc tải lên có nhiều khuôn mặt hoặc khuôn mặt không khớp với người đã xác minh có thể thất bại. project_name tách biệt tài nguyên trong tổ chức đã xác thực. Mặc định là default; dùng cùng một giá trị phân biệt chữ hoa, chữ thường cho nhóm và tài nguyên liên quan. Gửi trong nội dung JSON với POST/PUT và tham số truy vấn với GET/DELETE.

Ví dụ Yêu cầu

Ví dụ Phản hồi

Ủy quyền

Authorization
string
header
bắt buộc

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Nội dung

application/json
asset_url
string<uri>
bắt buộc

URL nguồn có thể truy cập công khai để nhập. TokenLab lưu trữ tài liệu để sử dụng sau; không dựa vào URL này làm địa chỉ tài liệu lâu dài.

asset_name
string

Tên hiển thị tùy chọn được lưu trữ cùng với tài sản tài liệu.

Required string length: 1 - 128
asset_type
enum<string>
mặc định:Image
Tùy chọn có sẵn:
Image,
Video,
Audio
library_type
enum<string>
mặc định:aigc_avatar

Lớp thư viện tài liệu. aigc_avatar dành cho tài liệu avatar ảo. liveness_face dành cho tài liệu người thật đã xác minh.

Tùy chọn có sẵn:
aigc_avatar,
liveness_face
group_id
string

ID nhóm tài liệu TokenLab. Bắt buộc đối với tài liệu liveness_face; tùy chọn đối với aigc_avatar.

project_name
string
mặc định:default

Phạm vi dự án cho tài sản tài liệu. Tài sản và nhóm được cô lập theo dự án bên trong tổ chức đã xác thực.

Required string length: 1 - 128
metadata
object | null

Metadata khách hàng tùy chọn được lưu trữ cùng với tài sản tài liệu.

Phản hồi

Tài nguyên vật liệu đã được tạo

id
string
bắt buộc

ID tài sản tài liệu TokenLab. Sử dụng ID này làm material_asset_id sau khi tài sản trở thành ACTIVE.

object
enum<string>
bắt buộc
Tùy chọn có sẵn:
seedance.material_asset
library_type
enum<string>
bắt buộc
Tùy chọn có sẵn:
aigc_avatar,
liveness_face
asset_type
enum<string>
bắt buộc
Tùy chọn có sẵn:
Image,
Video,
Audio
status
enum<string>
bắt buộc
Tùy chọn có sẵn:
PROCESSING,
ACTIVE,
FAILED,
DELETED
ready
boolean
bắt buộc

True khi tài sản đang hoạt động và không bị xóa.

group_id
string | null

ID nhóm tài liệu TokenLab sở hữu tài sản tài liệu này.

project_name
string

Phạm vi dự án cho tài sản tài liệu này.

asset_name
string | null
error_message
string | null

Lỗi xử lý kết thúc an toàn công khai. Các lỗi xác thực nguồn vĩnh viễn bao gồm ràng buộc kích thước bị từ chối.

metadata
object | null
created_at
integer

Dấu thời gian Unix khi bản ghi tài sản tài liệu được tạo.

updated_at
integer

Dấu thời gian Unix khi bản ghi tài sản tài liệu được cập nhật lần cuối.