> ## 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/{virtual_id}

## 소개

단일 자산을 조회하고 업스트림 처리 상태를 새로고침합니다. 비디오 생성 전 `status: active`를 확인하세요.

## 인증

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

## 경로 매개변수

<ParamField path="virtual_id" type="string" required>
  자산 ID(예: `asset-20260508120145-pqwhc`; `asset://` 뒤 부분과 일치)
</ParamField>

## 예제

```bash theme={null}
curl "https://api.gravitex.ai/v1/assets/asset-20260508120145-pqwhc" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"
```

## 상태

| status    | 의미                         |
| --------- | -------------------------- |
| `pending` | 업스트림 처리 중(얼굴 인식 포함); 계속 폴링 |
| `active`  | `asset://`로 비디오 생성에 사용 가능  |
| `failed`  | 처리 실패; 사양 확인 후 재업로드        |

> 게이트웨이는 자산 소유권을 검증합니다. 본인이 업로드한 자산만 사용할 수 있습니다.