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#
Bez parametrów zwraca bieżący miesiąc UTC. Aby pobrać inny miesiąc, podaj period=YYYY-MM.
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.