TokenLab

Video & tư liệu

Lấy Nhóm Tài Nguyên Vật Liệu

Truy xuất một nhóm vật liệu Seedance theo ID nhóm TokenLab.

GET
/v1/videos/assets/groups/{groupId}

Truy xuất một nhóm vật liệu. library_type cho bạn biết nhóm đó là nhóm avatar ảo hay nhóm người thật.

Sử dụng endpoint này trước khi tải lên nếu bạn cần xác nhận rằng nhóm vẫn tồn tại và có status: "ACTIVE".

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

curl "https://api.tokenlab.sh/v1/videos/assets/groups/group-20260720123456-vrt01?project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

Ví dụ Phản hồi

{
  "id": "group-20260720123456-vrt01",
  "object": "seedance.material_asset_group",
  "project_name": "default",
  "library_type": "aigc_avatar",
  "group_name": "Product references",
  "description": "Reusable product shots",
  "status": "ACTIVE",
  "metadata": null,
  "created_at": 1782998400000
}
curl -X GET "https://example.com/v1/videos/assets/groups/group-20260720123456-vrt01"
{  "id": "group-20260720123456-vrt01",  "object": "seedance.material_asset_group",  "library_type": "aigc_avatar",  "group_name": "Product references",  "description": "Ảnh sản phẩm có thể tái sử dụng",  "status": "ACTIVE",  "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

Tham số đường dẫn

groupId*string

Tham số truy vấn

project_name?string

Phạm vi dự án cho tài nguyên vật liệu.

Độ dài1 <= length <= 128
mặc định"default"

Phản hồi

application/json

application/json

application/json

application/json

application/json