Endpoints

Saldo och nyckelinfo

Läs ditt USD-saldo, din totala förbrukning och nyckelns gränser med GET /credits och GET /key, med exempel för att undvika att få slut på saldo.

Läs kontots saldo i USD, total förbrukning och den anropande nyckelns hastighetsgräns. Två sökvägar returnerar samma svar: /credits och /key, ett kortare alias.

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

Alla belopp anges i amerikanska dollar.

Anrop

Inga parametrar. Autentisera med din API-nyckel:

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

Svar

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

Fält	Beskrivning
`total_credits`	Totalt antal USD som någonsin lagts till på kontot: påfyllningar, användning som ingår i prenumerationen, bonusar och kampanjkoder.
`total_usage`	Totalt antal USD som spenderats på anrop.
`balance_usd`	Aktuellt tillgängligt saldo i USD.
`key_id`	Id för den API-nyckel som användes för det här anropet.
`rate_limit.requests`	Nyckelns egen gräns för anrop per minut, eller `null` om nyckeln använder din plans gräns.
`rate_limit.interval`	Alltid `1m`.

total_credits - total_usage kan avvika något från balance_usd på grund av återbetalningar och manuella justeringar. balance_usd är det som gäller.

Exempel: sluta innan saldot tar slut

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'

När saldot når 0 USD

Betalda anrop returnerar 402 insufficient_balance tills du fyller på, om du inte har aktiverat automatisk påfyllning under Fakturering. Att läsa /credits, /key och /models fungerar fortfarande. Se Priser och fakturering.

Fel

Status	Kod	När
401	`invalid_api_key`	Nyckeln saknas eller är ogiltig.

Se Fel.