> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create asset group

> POST /v1/asset-groups (aigc)

## Introduction

Create a virtual asset group (`group_type` = `aigc`). For `liveness_face`, use [Create asset group (liveness)](/en/api-reference/endpoint/seedance-2.0/create-visual-validate-session).

Up to **100** groups per user for aigc and liveness\_face (separate quotas).

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer Token, e.g. `Bearer sk-xxxxxxxxxx`
</ParamField>

## Request body

<ParamField body="name" type="string" required>
  Group name
</ParamField>

<ParamField body="description" type="string">
  Description; defaults to API key user `username` if omitted or empty (for BytePlus console attribution)
</ParamField>

<ParamField body="channel_id" type="integer">
  Upstream channel ID; auto-selected if omitted
</ParamField>

<ParamField body="group_type" type="string" default="aigc">
  Only `aigc`; not `liveness_face`
</ParamField>

## Example

```bash theme={null}
curl -X POST "https://api.gravitex.ai/v1/asset-groups" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "Character A", "description": "Test"}'
```

## Response

```json theme={null}
{
  "group_id": "group-20260508120000-abcde",
  "name": "Character A",
  "description": "Test",
  "channel_id": 123,
  "group_type": "aigc"
}
```

| Field         | Description                                                                                    |
| ------------- | ---------------------------------------------------------------------------------------------- |
| `group_id`    | Use with [Create asset](/en/api-reference/endpoint/seedance-2.0/create-asset) and delete group |
| `description` | Stored value (empty input → `username` fallback)                                               |
| `channel_id`  | Selected upstream channel                                                                      |

Save `group_id` for asset creation.