Endpoints

Saldo en key-info

Vraag je USD-saldo, totale uitgaven en de rate limit van de aanroepende key op met GET /credits of het kortere alias GET /key.

Lees het USD-saldo van je account, de totale uitgaven en de rate limit van de aanroepende key. Twee paden geven dezelfde body terug: /credits en /key, een korter alias.

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

Alle bedragen zijn in Amerikaanse dollars.

Request

Geen parameters. Authenticeer met je API-key:

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

Response

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

Veld	Beschrijving
`total_credits`	Totaal aan USD dat ooit aan het account is toegevoegd: opwaarderingen, inbegrepen abonnementsgebruik, bonussen en promocodes.
`total_usage`	Totaal aan USD dat aan requests is uitgegeven.
`balance_usd`	Huidig besteedbaar saldo in USD.
`key_id`	De id van de API-key die voor dit request is gebruikt.
`rate_limit.requests`	De eigen limiet van de key in requests per minuut, of `null` als de key de limiet van je abonnement gebruikt.
`rate_limit.interval`	Altijd `1m`.

total_credits - total_usage kan door terugbetalingen en handmatige correcties licht afwijken van balance_usd; balance_usd is leidend.

Voorbeeld: stoppen voordat je saldo op is

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'

Wanneer het saldo $0 bereikt

Betaalde requests geven 402 insufficient_balance terug totdat je saldo toevoegt, tenzij automatisch opwaarderen is ingeschakeld bij Facturering. Het lezen van /credits, /key en /models blijft werken. Zie Prijzen en facturering.

Fouten

Status	Code	Wanneer
401	`invalid_api_key`	Ontbrekende of ongeldige key.

Zie Fouten.