API REST / credits

Crédits

Solde de votre clé, coût d'un appel et options pour recharger. Gratuit.

GET/v1/credits0 crédits

Lit le solde à jour de la clé et liste les packs (et, pour le plan gratuit, les abonnements). Réponses : 200, 400 invalid_params, 401.

ParamètreTypeDéfautDescription
refused_toolstring—Un outil Normi (ex. analyze_price_trends) : la réponse indique son coût et si le solde le couvre.
curl "https://mcp.normi.fr/v1/credits?refused_tool=analyze_price_trends" \
  -H "X-API-Key: normi_votre_token"

Réponse (200)

{
  "balance": 4,
  "plan": "free",
  "required": 10,
  "covers_refused_call": false,
  "free_credits_reset_at": "2026-12-01",
  "spent_last_30_days": 496,
  "options": [
    { "kind": "pack", "id": "starter", "name": "Starter", "credits": 1000, "price_cents": 200 }
  ],
  "cheapest_covering_id": "pack:starter",
  "suggested_id": "pack:starter",
  "pricing_url": "https://www.normi.fr/pricing",
  "refused_tool": "analyze_price_trends",
  "refused_arguments": {},
  "_credits": { "used": 0, "remaining": 4 },
  "query_time_ms": 80
}

Équivalent MCP : show_credit_options, qui affiche ces options dans une fenêtre interactive.