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

# 자산 그룹 생성 (CreateAssetGroup)

> CreateAssetGroup — POST /api/v3/seedance

## 소개

가상 자산 그룹을 생성합니다. 어떤 `GroupType`을 전달하더라도 **강제로** `AIGC`로 덮어씁니다. 실인물 자산 그룹(`LivenessFace`)은 [CreateVisualValidateSession](/ko/api-reference/endpoint/seedance-2.0-new/create-visual-validate-session)을 통해서만 생성할 수 있습니다.

사용자당 자산 그룹 수 상한을 초과하면 `403`이 반환되며, `ResponseMetadata.Error.Code = "QuotaExceeded"`입니다.

## 인증

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

## 요청 매개변수

<ParamField body="Name" type="string" required>
  자산 그룹 이름
</ParamField>

<ParamField body="Description" type="string">
  설명
</ParamField>

<ParamField body="GroupType" type="string">
  어떤 값을 전달해도 강제로 `AIGC`로 설정됩니다
</ParamField>

<ParamField body="ProjectName" type="string" default="default">
  프로젝트 이름
</ParamField>

## 요청 예제

```bash theme={null}
curl -X POST "https://api.gravitex.ai/api/v3/seedance?Action=CreateAssetGroup&Version=2024-01-01" \
  -H "Authorization: Bearer sk-your_token_key" \
  -H "Content-Type: application/json" \
  -d '{"Name": "角色A", "Description": "测试角色"}'
```

## 응답 예제

```json theme={null}
{
  "ResponseMetadata": {"Action": "CreateAssetGroup", "Version": "2024-01-01", "Service": "ark"},
  "Result": {"Id": "group-20260710-abcde"}
}
```