> ## 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/assets

## 소개

현재 사용자의 자산을 나열하고, 처리 중인 업스트림 상태를 자동으로 새로고침합니다.

## 인증

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

## 쿼리 매개변수

<ParamField query="group_id" type="string">
  그룹 ID로 필터; **설정 시 `group_type` 무시**
</ParamField>

<ParamField query="group_type" type="string" default="aigc">
  `aigc`, `liveness_face`, 또는 `all`. **생략 시 가상 라이브러리 자산만 반환**
</ParamField>

## 예제

```bash theme={null}
# 기본값: 가상 라이브러리
curl "https://api.gravitex.ai/v1/assets" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

# 그룹별
curl "https://api.gravitex.ai/v1/assets?group_id=group-20260508120000-abcde" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

# 실인물 라이브러리 전체
curl "https://api.gravitex.ai/v1/assets?group_type=liveness_face" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"
```

## 응답

```json theme={null}
{
  "assets": [
    {
      "virtual_id": "asset-20260508120145-pqwhc",
      "asset_url": "asset://asset-20260508120145-pqwhc",
      "group_id": "group-20260508120000-abcde",
      "url": "https://signed-url.example.com/...",
      "filename": "portrait.jpg",
      "asset_type": "Image",
      "status": "active",
      "created_at": 1715140800
    }
  ],
  "total": 1
}
```

<Note>
  응답의 `url`은 업스트림 임시 서명 URL(약 12시간)로 미리보기 전용입니다. **비디오 생성에는 `asset_url`(`asset://`)을 사용하고, `url`은 사용하지 마세요.**
</Note>