> ## Documentation Index
> Fetch the complete documentation index at: https://studio-docs.thezet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 사용량

> 기간별로 얼마나 만들고 얼마를 썼는지 확인해요.

API로 만든 작업의 수와 금액을 날짜, 모델, API 키별로 묶어 받아요. 사이트에서 만든 작업은 들어가지 않아요.

```bash theme={null}
curl "https://api.studio.thezet.io/v1/usage?from=2026-11-01&to=2026-11-30&group_by=model" \
  -H "Authorization: Bearer $ZET_API_KEY"
```

| 쿼리 | 뜻 |
| - | - |
| `from` | 시작 날짜예요. 이날을 포함해요. 기본은 `to`가 속한 달의 1일이에요. |
| `to` | 끝 날짜예요. 이날을 포함해요. 기본은 오늘이에요. |
| `group_by` | `day`(기본), `model`, `api_key` 중 하나예요. |

날짜는 **UTC 기준**이고, 작업을 시작한 날로 세요. 기간은 366일까지이고, 넘으면 `400 invalid_range`예요.

```json theme={null}
{
  "from": "2026-11-01",
  "to": "2026-11-30",
  "group_by": "model",
  "totals": {
    "generations": 12,
    "succeeded": 10,
    "failed": 1,
    "canceled": 0,
    "active": 1,
    "spent_usd": "0.1000",
    "held_usd": "0.0100"
  },
  "rows": [
    {
      "group": "z-image-turbo",
      "name": "Z-Image Turbo",
      "generations": 12,
      "succeeded": 10,
      "failed": 1,
      "canceled": 0,
      "active": 1,
      "spent_usd": "0.1000",
      "held_usd": "0.0100"
    }
  ]
}
```

| 필드 | 뜻 |
| - | - |
| `spent_usd` | 성공한 작업에 청구된 금액이에요. |
| `held_usd` | 진행 중인 작업에 묶인 금액이에요. 끝나면 청구되거나 돌아가요. |
| `rows[].group` | 날짜, 모델 ID, API 키 ID, 또는 연결된 앱의 ID예요. |
| `rows[].name` | 모델, API 키, 또는 연결된 앱의 이름이에요. 날짜별로 묶으면 `null`이에요. |

작업이 없는 날은 `rows`에 나오지 않아요. 삭제한 작업도 청구 기록이 남으니 함께 세요.

## 사이트에서 보기

[설정의 사용 내역](https://studio.thezet.io/settings/api-usage)에서 같은 내용을 달별로 보고, 작업별 내역을 CSV로 받을 수 있어요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.