Prismatic API/Docs/Quota du compte
Documentation

Quota du compte

GET /v1/account/quota retourne les fenêtres de quota d’abonnement et le solde du portefeuille PAYG du compte authentifié.

Exemples de code

Bash
curl https://api.prismaticapi.com/v1/account/quota \
  -H "Authorization: Bearer $PRISMATIC_API_KEY"

Forme de la réponse

Exemple de réponse pour un plan en fenêtres avec crédit PAYG. model_access (limites de requêtes par modèle) est aussi retourné, omis ici par souci de concision.

JSON
{
  "object": "account.quota",
  "plan": {
    "name": "Pro",
    "quota_mode": "WINDOWED",
    "rate_limit_per_minute": 120
  },
  "windows": {
    "five_hours": {
      "limit": 1000,
      "used": 120,
      "reserved": 0,
      "remaining": 880,
      "reset_at": "2026-06-25T18:00:00Z"
    },
    "seven_days": {
      "limit": 20000,
      "used": 3400,
      "reserved": 0,
      "remaining": 16600,
      "reset_at": "2026-06-30T09:00:00Z"
    }
  },
  "daily": null,
  "balance": {
    "wallet_usd": "12.500000",
    "currency": "USD"
  },
  "generated_at": "2026-06-25T12:00:00Z"
}

Champs importants

  • windows.five_hours / windows.seven_days — fenêtres d’abonnement glissantes avec limit, used, reserved, remaining et reset_at.
  • daily — retourné à la place de windows pour les plans en mode daily ; sinon null.
  • plan — nom du plan, quota_mode (WINDOWED, DAILY ou UNLIMITED) et rate_limit_per_minute.
  • balance.wallet_usd — solde du portefeuille PAYG en USD, toujours présent.
  • plan, windows et daily sont null quand le compte n’a pas d’abonnement actif.

Pourquoi c’est utile

  • Interroge-le avant de gros travaux pour confirmer le quota restant et éviter les 429.
  • Utilise reset_at pour planifier les réessais une fois la fenêtre épuisée réinitialisée.
  • Authentifie-toi avec la même clé API que pour la génération ; les vérifications de quota comptent dans ta limite par minute.