Video & Materials
List Material Asset Groups
Lists Seedance material groups owned by the current organization.
List material groups owned by the authenticated organization. Filter by library_type and status to separate virtual-avatar groups from real-person groups.
Use a returned id when uploading materials. Do not pass a group_id as material_asset_id during video generation; generation requires a material asset id.
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?library_type=aigc_avatar&page_size=20&project_name=default" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"Example Response
{
"groups": [
{
"id": "group-20260720123456-vrt01",
"object": "seedance.material_asset_group",
"project_name": "default",
"library_type": "aigc_avatar",
"group_name": "Product references",
"status": "ACTIVE",
"created_at": 1782998400000
}
],
"next_page_token": null
}curl -X GET "https://example.com/v1/videos/assets/groups"{ "groups": [ { "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 }, { "id": "group-20260720123456-real1", "object": "seedance.material_asset_group", "library_type": "liveness_face", "group_name": "Creator A", "description": null, "status": "ACTIVE", "metadata": null, "created_at": 1782998400000 } ], "next_page_token": null}Authorization
BearerAuth API Key authentication. Create or manage API keys in Dashboard > API > API Keys.
In: header
Query Parameters
1 <= value <= 10020Value in
- "ACTIVE"
- "DELETED"
Filter by TokenLab material library class.
Value in
- "aigc_avatar"
- "liveness_face"
Project scope for the material resource.
1 <= length <= 128"default"Response
application/json
application/json
application/json
application/json