Le système de gestion des clés API de LibreTranslate permet d’établir des quotas de limites d’utilisation par utilisateur. Cette fonctionnalité est conçue pour permettre à des utilisateurs spécifiques de bénéficier de limites de requêtes par minute (taux de rafraîchissement) plus élevées que la limite par défaut du serveur.
--req-limit de LibreTranslate.api_key aux points de terminaison REST, l’utilisateur concerné bénéficie de la limite de requêtes supérieure associée à cette clé.Pour activer la prise en charge de la gestion des clés API, le serveur LibreTranslate doit être démarré avec l’option suivante :
--api-keys
ltmanage keys)L’outil en ligne de commande ltmanage keys est utilisé pour émettre, supprimer et visualiser les clés API.
Cette commande génère une nouvelle clé API et lui assigne une limite de requêtes par minute.
Syntaxe : ltmanage keys add <limite_requetes_par_minute>
Exemple : Pour émettre une nouvelle clé avec une limite fixée à 120 requêtes par minute :
ltmanage keys add 120
Cette commande révoque et supprime une clé API existante du système.
Syntaxe : ltmanage keys remove <api-key>
Exemple :
ltmanage keys remove a1b2c3d4e5f6g7h8i9j0
Cette commande liste toutes les clés API actuellement actives ainsi que la limite de requêtes associée à chacune.
ltmanage keysPour bénéficier de la limite de requêtes supérieure, la clé API doit être transmise dans la requête de traduction HTTP, généralement dans le corps de la requête (méthode POST).
| Paramètre | Rôle |
|---|---|
q, source, target |
Paramètres de traduction standard. |
api_key |
Clé unique pour bénéficier du quota élevé. |
curl (Exemple)Cet exemple montre une requête de traduction Anglais vers Français, incluant la clé API :
curl -X POST "http://localhost:5000/translate" \
-H "Content-Type: application/json" \
-d '{
"q": "Hello World",
"source": "en",
"target": "fr",
"api_key": "a1b2c3d4e5f6g7h8i9j0"
}'