Endpoints

Solde et infos de clé

Lisez votre solde en USD, vos dépenses totales et la limite de débit de la clé avec GET /credits et GET /key, et évitez les erreurs 402.

Lisez le solde en USD de votre compte, vos dépenses totales et la limite de débit de la clé appelante. Deux chemins renvoient le même corps : /credits et /key, un alias plus court.

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

Tous les montants sont en dollars américains.

Requête

Aucun paramètre. Authentifiez-vous avec votre clé d'API :

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

Réponse

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

Champ	Description
`total_credits`	Total en USD jamais ajouté au compte : recharges, utilisation incluse dans l'abonnement, bonus et codes promo.
`total_usage`	Total en USD dépensé en requêtes.
`balance_usd`	Solde disponible actuel en USD.
`key_id`	L'identifiant de la clé d'API utilisée pour cette requête.
`rate_limit.requests`	La limite de requêtes par minute propre à la clé, ou `null` si la clé utilise la limite de votre forfait.
`rate_limit.interval`	Toujours `1m`.

total_credits - total_usage peut différer légèrement de balance_usd à cause des remboursements et des ajustements manuels ; balance_usd fait foi.

Exemple : s'arrêter avant d'être à court

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"Solde faible : ${balance:.2f}. Ajoutez des fonds sur /dashboard/billing")

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

Quand le solde atteint 0 $

Les requêtes payantes renvoient 402 insufficient_balance tant que vous n'ajoutez pas de fonds, sauf si la recharge automatique est activée dans Facturation. La lecture de /credits, /key et /models continue de fonctionner. Voir Tarifs et facturation.

Erreurs

Statut	Code	Quand
401	`invalid_api_key`	Clé manquante ou invalide.

Voir Erreurs.