TokenLab

Video & Materials

Get Material Asset Group

Retrieves one Seedance material group by TokenLab group ID.

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

Retrieve one material group. The library_type tells you whether the group is a virtual-avatar group or a real-person group.

Use this endpoint before uploading if you need to confirm that the group still exists and has status: "ACTIVE".

project_name isolates resources within the authenticated organization. It defaults to default; use the same case-sensitive value for related groups and assets. Send it in the JSON body for POST/PUT and in the query string for GET/DELETE.

Example Request

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

Example Response

{
  "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": "Reusable product shots",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

Authorization

BearerAuth
AuthorizationBearer <token>

API Key authentication. Create or manage API keys in Dashboard > API > API Keys.

In: header

Path Parameters

groupId*string

Query Parameters

project_name?string

Project scope for the material resource.

Length1 <= length <= 128
default"default"

Response

application/json

application/json

application/json

application/json

application/json