TokenLab

Video & tư liệu

Tạo Material Asset

Tải lên một Seedance material asset vào một nhóm material của TokenLab.

POST
/v1/videos/assets

Nhập một URL nguồn có thể truy cập công khai vào một nhóm material của Seedance. TokenLab lưu trữ material để sử dụng sau này; hãy sử dụng id của material asset đượ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; nếu không có, TokenLab sẽ sử dụng hoặc tạo nhóm virtual-avatar 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. group_id cũng là bắt buộc khi project_name không phải là default. Nhóm phải thuộc cùng project_name và library_type, nếu không yêu cầu sẽ trả về 400.

LoạiĐầu vào được hỗ trợ
Hình ảnhjpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; chiều rộng và chiều cao [300, 6000] px; tỷ lệ khung hình [0.4, 2.5].
Videomp4, mov; ≤200 MiB.
Âm thanhaac, wav, mp3; ≤15 MiB.

TokenLab kiểm tra URL nguồn, loại phương tiện, kích thước tệp và kích thước hình ảnh (nếu có thể đọc được) trước khi chấp nhận yêu cầu. Nguồn không vượt qua các kiểm tra này sẽ trả về 400 kèm theo mã seedance_material_source_*, ví dụ: seedance_material_source_invalid (kích thước hình ảnh hoặc tỷ lệ khung hình nằm ngoài phạm vi), seedance_material_source_type_mismatch, seedance_material_source_too_large, hoặc seedance_material_source_url_unreachable. Các yêu cầu khác về phương tiện và khuôn mặt được đánh giá trong quá trình xử lý, vì vậy việc chấp nhận không có nghĩa là asset đã sẵn sàng: hãy đợi trạng thái ACTIVE và kiểm tra error_message nếu quá trình xử lý thất bại.

Một yêu cầu thành công sẽ trả về 201 với status: "PROCESSING". 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 ánh xạ tới một người đã xác minh; việc tải lên 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 xác định phạm vi tài nguyên trong tổ chức của bạn và mặc định là default. Hãy sử dụng cùng một giá trị phân biệt chữ hoa chữ thường cho các nhóm và asset liên quan. Gửi giá trị này trong phần thân JSON cho POST/PUT và trong chuỗi truy vấn (query string) cho GET/DELETE.

Ví dụ yêu cầu

curl https://api.tokenlab.sh/v1/videos/assets \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","project_name":"default"}'

Ví dụ phản hồi

{
  "id": "asset-20260720123456-qn7wr",
  "object": "seedance.material_asset",
  "project_name": "default",
  "group_id": "group-20260720123456-vrt01",
  "library_type": "aigc_avatar",
  "asset_name": "Front view",
  "asset_type": "Image",
  "status": "PROCESSING",
  "ready": false,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X POST "https://example.com/v1/videos/assets" \  -H "Content-Type: application/json" \  -d '{    "asset_url": "https://example.com/reference.png",    "asset_name": "Front view",    "asset_type": "Image",    "library_type": "aigc_avatar",    "group_id": "group-20260720123456-vrt01"  }'
{  "id": "asset-20260720123456-qn7wr",  "object": "seedance.material_asset",  "group_id": "group-20260720123456-vrt01",  "library_type": "aigc_avatar",  "asset_name": "Front view",  "asset_type": "Image",  "status": "PROCESSING",  "ready": false,  "error_message": null,  "metadata": null,  "created_at": 1782998400000}

Xác thực

BearerAuth
AuthorizationBearer <token>

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

Vị trí: header

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json