Crédits d'API

L'API de recherche est prépayée. Vous détenez un solde de crédits API, dans la devise de votre compte, et chaque requête facturable le débite. C'est le modèle à la Anthropic : payer ce qu'on utilise, depuis un solde rechargé à l'avance. La recherche sur le site est couverte par votre abonnement et ne touche jamais ce solde — les crédits ne concernent que l'API.

Deux enveloppes

Votre solde est la somme de deux enveloppes distinctes :

Une requête dépense d'abord l'enveloppe incluse, puis l'achetée : un forfait mensuel est toujours consommé avant le crédit payé. Un débit ne fait jamais passer une enveloppe sous zéro ; une requête en cours aboutit toujours, et le solde s'arrête à zéro.

Le forfait mensuel (Suede Ultimate)

Suede Ultimate inclut chaque période l'équivalent de 1 000 requêtes API, déposé dans l'enveloppe incluse. En USD cela fait 20,00 $ (1 000 × 0,02 $ la requête) ; le montant équivalent est accordé dans la devise de chaque région. Le forfait est accordé à l'activation de l'abonnement, puis au début de chaque période.

Suede Pro n'inclut pas de forfait mensuel : les membres Pro utilisent l'API purement à l'usage, en achetant des crédits au besoin. Changer de formule prend effet au prochain renouvellement : votre première période Ultimate démarre le forfait, votre première période Pro y met fin (le crédit inclus restant expire avec sa dernière période Ultimate, comme toujours).

Le coût d'une requête

Chaque requête facturable coûte un montant fixe dans votre devise :

Consulter son solde

• Dans le navigateur — ouvrez Réglages → Facturation → Crédits API (ou directement /account/credits) : total, chaque enveloppe, date de réinitialisation de l'enveloppe incluse et estimation du nombre de requêtes couvertes.
• Depuis l'API — appelez GET /v1/usage. Il renvoie included_cents, purchased_cents, le total et une estimation du nombre de requêtes, sans jamais consommer de crédit. Le même solde accompagne chaque réponse facturable dans les en-têtes X-Credits-Balance et X-Credits-Requests-Remaining.

Quand le solde est épuisé

À zéro, les endpoints facturables renvoient 402 insufficient_credits. La solution : acheter des crédits ou activer la recharge automatique. Lire son utilisation fonctionne toujours à zéro — GET /v1/usage n'est jamais conditionné au crédit.