> ## 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.

# 자산 그룹 생성

> POST /v1/asset-groups (aigc)

## 소개

가상 자산 그룹을 생성합니다(`group_type` = `aigc`). `liveness_face`의 경우 [자산 그룹 생성(실인물)](/ko/api-reference/endpoint/seedance-2.0/create-visual-validate-session)을 사용하세요.

aigc와 liveness\_face 각각 사용자당 최대 **100**개 그룹(별도 할당량).

## 인증

<ParamField header="Authorization" type="string" required>
  Bearer Token, 예: `Bearer sk-xxxxxxxxxx`
</ParamField>

## 요청 본문

<ParamField body="name" type="string" required>
  그룹 이름
</ParamField>

<ParamField body="description" type="string">
  설명; 생략하거나 비어 있으면 API 키 사용자 `username`이 기본값으로 사용됩니다(BytePlus 콘솔 귀속 표시용)
</ParamField>

<ParamField body="channel_id" type="integer">
  업스트림 채널 ID; 생략 시 자동 선택
</ParamField>

<ParamField body="group_type" type="string" default="aigc">
  `aigc`만 지원; `liveness_face`는 이 엔드포인트에서 생성 불가
</ParamField>

## 예제

```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"}'
```

## 응답

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

| 필드            | 설명                                                                        |
| ------------- | ------------------------------------------------------------------------- |
| `group_id`    | [자산 생성](/ko/api-reference/endpoint/seedance-2.0/create-asset) 및 그룹 삭제에 사용 |
| `description` | 저장된 값(빈 입력 → `username` 대체)                                               |
| `channel_id`  | 선택된 업스트림 채널                                                               |

자산 생성에 사용할 `group_id`를 저장하세요.