---
title: API użycia
description: Odczytuj miesięczne naliczone ilości, znormalizowane jednostki, prognozowane kwoty i brakujące pozycje cennika.
species: reference
---
# API użycia

Dane o użyciu są tylko do odczytu, wymagają zakresu `data:read` i pochodzą z godzinowego rejestru użycia oraz cenników Supernova. Endpoint nie wysyła bieżącego żądania do dostawcy rozliczeń.

## Odczyt miesiąca

```endpoint
GET /usage
```

Bez parametrów zwraca bieżący miesiąc UTC. Aby pobrać inny miesiąc, podaj `period=YYYY-MM`.

```bash
curl "https://api.supernova.ai/usage?period=2026-07" \
  -H "Authorization: Bearer pat_..."
```

Ilości są przeliczane na jednostki prezentowane użytkownikowi. Wycenione wiersze zawierają `amount_cents`. Niewyceniony rodzaj użycia ma `amount_cents: null` i pojawia się w `missing_rate_card_kinds`; klient nie może traktować wartości null jako zerowego kosztu.

| Rodzaj | Jednostka prezentacji |
|---|---|
| `compute_gb_sec` | GB-godzina |
| `storage_gb_hour` | GB-miesiąc |
| `egress_byte` | GB |
| `read_op`, `write_op`, `list_op` | milion operacji |
| `ai_token_in`, `ai_token_out` | milion tokenów |

## Lista dostępnych miesięcy

Podaj `periods=1`, aby wyświetlić miesiące z użyciem, zaczynając od najnowszego. Nie można łączyć `period` z `periods=1`.

`400 invalid_period` oznacza nieprawidłowy miesiąc lub niedozwolone połączenie parametrów. `400 invalid_periods` oznacza wartość inną niż `1`.

Wartości bieżącego miesiąca są prognozami i mogą się zmieniać wraz z pojawianiem się nowych rekordów godzinowych. Wartości zamkniętego miesiąca nadal pochodzą z tego samego rejestru, ale mogą się zmienić po zastosowaniu poprawionego cennika.