---
title: "Create Seedance material asset group"
method: POST
path: "/v1/videos/assets/groups"
tags: ["Video"]
---

# Create Seedance material asset group

`POST /v1/videos/assets/groups`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/videos/assets/groups`
- Auth: HTTP bearer

Creates a TokenLab Seedance virtual-avatar material group. Real-person material groups are created by GetVisualValidateResult after the H5 validation succeeds.

## Request body

- SeedanceMaterialAssetGroupCreateRequest
  - `group_name` string: Optional display name for the material group.
  - `description` string, nullable
  - `library_type` 'aigc_avatar' | 'liveness_face': Material library class. Direct creation supports aigc_avatar. Create liveness_face groups through CreateVisualValidateSession followed by GetVisualValidateResult.
  - `project_name` string: Project scope for the material group.
  - `metadata` object, nullable

## Response `201`

Material asset group created

- SeedanceMaterialAssetGroup
  - `id` string, required: TokenLab material group ID. Use it as group_id when uploading materials.
  - `object` 'seedance.material_asset_group', required
  - `library_type` 'aigc_avatar' | 'liveness_face', required
  - `project_name` string: Project scope for this material group.
  - `group_name` string, nullable
  - `description` string, nullable
  - `status` string, required
  - `metadata` object, nullable
  - `created_at` integer
  - `updated_at` integer

## Other responses

- `400`: Bad Request - Invalid input
- `401`: Unauthorized - Invalid or missing API key
- `409`: Material group mapping conflict
- `500`: Internal Server Error
- `503`: Material library unavailable

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)
