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

# 자산 그룹 목록 조회

> GET /v1/asset-groups

## 소개

현재 사용자의 자산 그룹을 나열합니다. 사용자는 자신의 그룹만 조회하고 작업할 수 있습니다.

## 인증

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

## 쿼리 매개변수

<ParamField query="group_type" type="string" default="aigc">
  `aigc`, `liveness_face`, 또는 `all`. **생략 시 가상 그룹만 반환**—실인물 그룹은 `liveness_face` 또는 `all` 사용
</ParamField>

## 예제

```bash theme={null}
# 기본값: 가상 그룹만
curl "https://api.gravitex.ai/v1/asset-groups" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

# 실인물 그룹만
curl "https://api.gravitex.ai/v1/asset-groups?group_type=liveness_face" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

# 전체
curl "https://api.gravitex.ai/v1/asset-groups?group_type=all" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"
```

## 응답

```json theme={null}
{
  "groups": [
    {
      "group_id": "group-20260508120000-abcde",
      "group_type": "aigc",
      "name": "Character A",
      "description": "Test",
      "channel_id": 123,
      "space_label": "A",
      "asset_count": 3,
      "created_at": 1715140800,
      "updated_at": 1715140800
    }
  ],
  "total": 1,
  "has_byteplus_channels": true
}
```

| 필드                      | 설명                              |
| ----------------------- | ------------------------------- |
| `group_type`            | `aigc` 또는 `liveness_face`       |
| `space_label`           | 다중 공간 설정에서의 채널 레이블(A / B / C…)  |
| `asset_count`           | 그룹 내 현재 자산 수                    |
| `has_byteplus_channels` | 사용자가 BytePlus 업스트림 채널을 구성했는지 여부 |