Crédits et soldes
Fonctionnement des crédits Piloterr et recharge de votre solde.
Chaque appel facturable déduit des crédits de votre espace de travail. Le panneau Utilisation du tableau de bord, sous Paramètres → Abonnement, affiche trois soldes. Le point d'accès usage de l'API renvoie une marge combinée pour que vous puissiez alerter depuis le code sans analyser chaque compartiment.
Utilisation
Période actuelle38,400
10,000
3,780
Abonnement
Pro · renouvelé le 1er
Les trois soldes
| Solde | Ce que c'est | Réinitialisation |
|---|---|---|
| Quota abonnement | Appels API inclus dans votre offre | Oui — au début de chaque période de facturation (depuis Stripe si disponible, sinon le mois calendaire). Le quota non utilisé n'est pas reporté. |
| Pack API ponctuel | Quota API additionnel issu d'un achat unique | Jamais — consommé jusqu'à épuisement, d'une période à l'autre |
| Crédits pay-as-you-go | Un journal distinct, utilisé seulement après épuisement du quota abonnement et des packs API | Jamais — les crédits restent jusqu'à consommation |
Dans le tableau de bord, ces trois barres apparaissent sous Paramètres → Abonnement → Utilisation (et dans le panneau Utilisation API de la barre latérale). Sur le point d'accès usage (/v2/usage), l'objet subscription est le quota API combiné (abonnement + packs restants). Le pay-as-you-go est sous credits. Le remaining de premier niveau est la somme des deux.
Ordre de consommation
Le quota abonnement d'abord
Les appels facturables remplissent l'allocation de l'offre pour la période en cours.
Puis les packs API ponctuels
Quand l'allocation de la période est épuisée, le quota restant des packs est consommé ensuite. Les packs sont imputés dans l'ordre d'achat.
Puis les crédits pay-as-you-go
Ce n'est que si le quota API combiné ne peut pas couvrir le coût du point d'accès que nous débitons le journal pay-as-you-go.
Sinon l'appel est refusé
L'API renvoie 402 avec Payment required, et la requête n'est pas exécutée.
Ce qui est facturé
| Résultat | Crédits |
|---|---|
200 ou 201 (réponse facturable réussie / acceptée) | Oui — le coût en crédits du point d'accès |
404 | En général oui — sauf si ce point d'accès marque le 404 comme gratuit (indiqué dans la Bibliothèque et sur la page du point d'accès) |
401, 402, 400, 5xx et la plupart des autres erreurs | Non — et toute réserve pay-as-you-go est libérée |
| Points d'accès par ligne avec 0 résultat | Gratuit |
| Points d'accès par ligne avec N résultats | N × le coût par ligne — tout ou rien (solde insuffisant → 402 avant qu'aucune ligne ne soit renvoyée) |
/v2/usage et URL de statut de job | Toujours gratuit — aucun contrôle de quota |
Chaque point d'accès déclare son coût dans la Bibliothèque (et dans la Référence API) : N crédits par appel ou par ligne. Le solde est vérifié avant le démarrage du travail, donc une tâche n'est jamais acceptée sans les crédits pour la payer. Interroger le statut d'une tâche ne coûte jamais de crédits.
Acheter plus de capacité
Ouvrir les réglages d'abonnement
Allez dans Paramètres → Abonnement et cliquez sur Voir tous les plans (ou ouvrez https://app.piloterr.com/pricing).
Choisir un pack ponctuel
Selon le produit, un pack s'ajoute au quota API (pack API ponctuel) ou au journal pay-as-you-go. Il ne change jamais votre offre à lui seul. Les packs plus grands coûtent en général moins cher par crédit.
Confirmer le paiement
La capacité est disponible dès que le paiement réussit, et une facture est envoyée par e-mail à l'adresse de facturation.
Les packs achetés apparaissent aussi sous Paramètres → Abonnement → Packs ponctuels. Pour recharger automatiquement quand le solde combiné baisse, voir Recharge automatique.
Où lire l'historique
| Écran | Ce qu'il montre |
|---|---|
| Paramètres → Abonnement → Utilisation | Restant / utilisé en direct pour les trois soldes de la période en cours |
| Journaux API | Chaque requête avec statut, durée et crédits facturés — y compris l'usage abonnement et packs |
| Paramètres → Crédits | Le journal pay-as-you-go uniquement : crédits (récompenses, certains types de packs, recharge automatique) et dépenses survenues après épuisement du quota API. Filtrez par membre ou par type. |
Point d'accès usage (/v2/usage) | Instantané lisible par machine : remaining, subscription, credits, renewal_date — gratuit à appeler |
Si Paramètres → Crédits semble vide alors qu'Analytics montre du trafic, c'est normal : la consommation abonnement et packs n'apparaît jamais sur cette page. Utilisez les Journaux API ou les barres Utilisation à la place.
Quand vous voyez 402
| Message | Signification | Que faire |
|---|---|---|
Payment required | Plus de quota abonnement, de packs ni de pay-as-you-go pour le coût de cet appel | Achetez un pack, augmentez l'offre, ou activez la recharge automatique |
You have open invoices: … | Une facture impayée bloque le compte | Réglez-la sous Paramètres → Factures — le solde seul ne suffit pas |
Insufficient credits: X required, Y available | Un point d'accès par ligne renverrait plus de lignes que vous ne pouvez en payer | Rechargez, ou restreignez la requête pour obtenir moins de lignes |
FAQ
- Le quota d'offre non utilisé est-il reporté ? Non. Le compartiment abonnement se réinitialise à chaque période de facturation.
- Les packs ponctuels expirent-ils en fin de mois ? Non. Ils restent jusqu'à consommation.
- Toutes les clés partagent-elles les mêmes soldes ? Oui — le quota est à l'échelle de l'espace de travail.
- Vérifier l'usage coûte-t-il des crédits ? Non.
/v2/usageet les chemins de statut de job sont gratuits. - Pourquoi Utilisation du tableau de bord est-il séparé alors que
/usage.subscriptionest combiné ? Pour qu'un seul nombreremainingsuffise aux alertes ; ouvrez le tableau de bord quand vous avez besoin de la répartition en trois.