Limites de débit
Chaque clé a deux limites : requêtes par minute et par jour (le jour est compté en UTC). GET /me indique les valeurs de votre clé dans rateLimit (rpm et rpd).
Chaque réponse à un appel authentifié indique l'état de la limite la plus proche d'être atteinte, téléchargements de fichiers compris (ils comptent aussi dans la limite de débit). Les réponses produites avant la vérification de la clé ou de la limite ne portent pas ces en-têtes : clé invalide (401), corps mal formé (400), chemin inconnu (404), paramètres de requête invalides (400 validation), scope manquant (403 forbidden_scope), écriture refusée pour une clé de test (403).
Dans le navigateur (CORS), les en-têtes RateLimit-*, Retry-After, Grem-Sandbox, X-Request-Id et Content-Range sont lisibles.
RateLimit-Limit: 60
RateLimit-Remaining: 12
RateLimit-Reset: 41
| En-tête | Signification |
|---|---|
RateLimit-Limit | requêtes autorisées dans la fenêtre en cours |
RateLimit-Remaining | requêtes restantes |
RateLimit-Reset | secondes avant la réinitialisation de la fenêtre |
Au-delà de la limite, vous recevez 429 avec title: rate_limited et un en-tête Retry-After. La limite de débit est une protection technique ; elle ne facture jamais rien.
Surveillez RateLimit-Remaining et étalez vos requêtes dans le temps. L'interrogation du statut des tâches compte aussi dans la limite de débit, bien qu'elle soit gratuite : n'interrogez pas plus d'une fois toutes les quelques secondes, ou passez aux webhooks.
Facturation
Il n'existe pas de forfait API distinct : l'accès fait partie de votre abonnement, et les actions payantes sont débitées du même portefeuille que dans l'espace personnel.
Un appel payant comporte deux parties :
- L'appel API. Il est pris sur le quota d'appels API inclus dans votre forfait. Au-delà du quota, les appels sont facturés à l'usage.
- Le prix de l'outil - le même que celui de l'action dans l'espace personnel (sur le quota inclus dans le forfait ou sur le portefeuille).
Quota d'appels API par forfait :
| Forfait | Appels API par mois |
|---|---|
| Free | 100 |
| Start | 5,000 |
| PRO | 25,000 |
| MAX | 100,000 |
| Agency Start | 50,000 |
| Agency Growth | 250,000 |
| Agency Scale | illimité dans le cadre d'un usage raisonnable |
Pour les autres forfaits ainsi que les quotas et prix actuels des outils, consultez la page des forfaits dans l'espace personnel.
Ce qui est payant et ce qui est gratuit
La classe de facturation de chaque opération figure dans /openapi.json, champ x-grem-billing : free, api_call ou api_call+sku:... (un appel plus le prix de l'outil).
| Payant | Gratuit |
|---|---|
lancement des outils (POST vers l'estimation, les textes, la vidéo, la photo, le PDF, le site, etc.) - appel + prix de l'outil | toute lecture (GET), y compris l'interrogation des tâches et le téléchargement des fichiers |
| confirmation du flyer et de la vérification de rapport - appel uniquement | biens : création, modification, suppression |
| message de chat - appel + prix du message | leads et Swipe Match : création, modification, événements |
| création, modification et suppression de sessions de chat - appel uniquement | envoi d'images |
| gestion des webhooks |
Une requête refusée (4xx ou 5xx) ne consomme aucun appel API. L'exception est 502 provider_error après un dépassement de délai : le travail peut tout de même aboutir et être facturé - vérifiez GET /works (amélioration de photos, site et brouillon : dans l'espace personnel ou dans vos biens). Une nouvelle tentative de l'estimation express avec le même Idempotency-Key renvoie le résultat gratuitement (ni l'estimation ni l'appel API ne sont facturés) ; pour les autres outils, la clé reste occupée pendant 15 minutes après un dépassement de délai - vérifiez le résultat au lieu de répéter l'appel.
Les appels, les dépenses et les erreurs par clé sont visibles dans l'espace personnel, page API, onglet Analytique.
Voir aussi
- Erreurs -
402et429. - Idempotence - des nouvelles tentatives sûres, sans double facturation.