DeepL API : Garder un œil sur la consommation de caractères

Les traductions via l'API DeepL sont pratiques et s'intègrent parfaitement dans les flux de travail - mais la limite de caractères est vite atteinte, surtout avec la version gratuite. Combien de fois t'es-tu demandé : "Combien de caractères ai-je déjà utilisés aujourd'hui ?" Je vais te montrer comment tu peux à tout moment consulter l'état actuel - avec des commandes simples et sans devoir faire des devinettes dans le tableau de bord.

Comprendre les limites de l'API DeepL

Avec l'API gratuite DeepL ("DeepL API Free"), une limite mensuelle fixe de 500.000 caractères s'applique. Il n'y a pas de limite quotidienne - tu peux répartir les 500.000 caractères comme tu le souhaites au cours du mois, jusqu'à ce qu'ils soient épuisés. Dès que la limite est atteinte, plus aucune traduction n'est effectuée jusqu'au début du mois de facturation suivant.

Avec DeepL API Pro, tu paies en revanche en fonction de la consommation, sans limite mensuelle fixe. Dans ce cas, il est d'autant plus important de garder un œil sur la consommation afin d'éviter que les coûts ne s'envolent de manière inattendue.

Problème : L'affichage de la consommation ne s'actualise pas automatiquement.

Un problème typique : tu travailles toute la journée avec l'API, tu traduis assidûment des textes dans différentes langues, mais l'affichage des caractères consommés dans le compte DeepL n'a pas changé. Cela est dû au fait que l'affichage n'est pas actualisé en temps réel. Il ne fait que refléter l'état enregistré lors de la consultation explicite des données d'utilisation.

Consulter la consommation de caractères au cours du mois

Avec une simple commande cURL, tu peux à tout moment consulter ta consommation actuelle - sans passer par l'interface web. Voici comment tu dois procéder :

Pour DeepL API Free :

curl -X GET "https://api-free.deepl.com/v2/usage" -H "Authorization : DeepL-Auth-Key DEIN_API_KEY"

Pour DeepL API Pro :

curl -X GET "https://api.deepl.com/v2/usage" -H "Authorization : DeepL-Auth-Key DEIN_API_KEY"

La réponse est un objet JSON clair avec toutes les infos importantes :

{ "character_count" : 123456, "character_limit" : 500000 }

Tu vois immédiatement :

• Combien de caractères tu as déjà utilisés (character_count)
• Ta limite mensuelle (character_limit)

Conclusion : plus de mauvaises surprises

Avec la requête API présentée, tu as à tout moment un aperçu de ta consommation de caractères DeepL. Plus de devinettes, plus de mauvaises surprises en cours d'utilisation. Tu sais exactement où tu en es et tu peux planifier en conséquence.

Cela crée de la sécurité - pour toi, pour tes projets et finalement aussi pour tes clients qui peuvent compter sur des traductions ponctuelles.

Back