Tạo Tài nguyên Vật liệu

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ầuCopy Anchor Link

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ồiCopy Anchor Link

{
  "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
}

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}