Endpointy

Saldo i limity klucza

Sprawdź saldo konta w USD, łączne wydatki i limit zapytań klucza API przez endpointy GET /credits oraz GET /key bramki api14.

Odczytaj saldo konta w USD, łączne wydatki oraz limit zapytań klucza, którym się uwierzytelniasz. Dwie ścieżki zwracają to samo ciało odpowiedzi: /credits i /key, krótszy alias.

GET https://api14.com/api/v1/credits
GET https://api14.com/api/v1/key

Wszystkie kwoty są podawane w dolarach amerykańskich.

Żądanie

Brak parametrów. Uwierzytelnij się kluczem API:

curl https://api14.com/api/v1/credits \
  -H "Authorization: Bearer sk-api14-..."

Odpowiedź

{
  "data": {
    "total_credits": 145.0,
    "total_usage": 102.82,
    "balance_usd": 42.18,
    "key_id": "ckey_01JABCDEF",
    "rate_limit": { "requests": 120, "interval": "1m" }
  }
}

Pole	Opis
`total_credits`	Łączna kwota w USD dodana do konta: doładowania, zużycie wliczone w subskrypcję, bonusy i kody promocyjne.
`total_usage`	Łączna kwota w USD wydana na zapytania.
`balance_usd`	Aktualne saldo do wydania w USD.
`key_id`	Identyfikator klucza API użytego w tym zapytaniu.
`rate_limit.requests`	Własny limit zapytań na minutę dla klucza lub `null`, jeśli klucz korzysta z limitu planu.
`rate_limit.interval`	Zawsze `1m`.

Wartość total_credits - total_usage może się nieznacznie różnić od balance_usd z powodu zwrotów i ręcznych korekt; wiążące jest balance_usd.

Przykład: zatrzymaj się, zanim środki się skończą

import os, requests

r = requests.get(
    "https://api14.com/api/v1/credits",
    headers={"Authorization": f"Bearer {os.environ['API14_API_KEY']}"},
)
balance = r.json()["data"]["balance_usd"]
if balance < 1:
    raise SystemExit(f"Balance low: ${balance:.2f}. Add funds at /dashboard/billing")

curl -s https://api14.com/api/v1/key \
  -H "Authorization: Bearer $API14_API_KEY" | jq '.data.balance_usd'

Gdy saldo spadnie do 0 USD

Płatne zapytania zwracają 402 insufficient_balance, dopóki nie doładujesz konta, chyba że w sekcji Billing włączono automatyczne doładowanie. Odczyt /credits, /key i /models nadal działa. Zobacz Ceny i rozliczenia.

Błędy

Status	Kod	Kiedy
401	`invalid_api_key`	Brak klucza lub klucz jest nieprawidłowy.

Zobacz Błędy.