Fournisseurs de LLM
Chaque pipeline de traduction — translate-ui, translate-docs, translate-json et translate-svg — envoie du texte à un LLM via le même client indépendant du fournisseur. Avant que l'une de ces commandes ne puisse s'exécuter, configurez au moins un fournisseur dans ai-i18n-tools.config.json et définissez la clé API correspondante dans votre environnement ou .env (préréglages intégrés sauf Ollama). init écrit un bloc de démarrage provider / providers ; vous devez toujours fournir les informations d'identification pour le préréglage actif.
Vous configurez quel point de terminaison d'API appeler une seule fois dans la configuration ; toutes les commandes de traduction partagent cette configuration et le même cache SQLite. Le choix des modèles que ce fournisseur essaie est une étape distincte : Modèles d'IA.
La CLI résout le fournisseur actif à partir de la clé provider de niveau supérieur (ou de la seule entrée dans providers lorsqu'un seul est configuré). Chaque bloc de fournisseur répertorie une chaîne de secours translationModels ordonnée ; les préréglages intégrés héritent automatiquement de baseUrl et de la variable d'environnement de clé API (les remplacer par fournisseur si nécessaire).
Fournisseurs intégrés
Les clés de fournisseur prédéfinies n'ont besoin que de translationModels — l'URL de base et la variable d'environnement de clé API sont renseignées automatiquement :
| Fournisseur | Variable d'environnement de clé API | URL de base |
|---|---|---|
alibaba | ALIBABA_API_KEY | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
anthropic | ANTHROPIC_API_KEY | https://api.anthropic.com/v1 |
apikeyfan | APIKEYFAN_API_KEY | https://api.apikey.fan/v1 |
cerebras | CEREBRAS_API_KEY | https://api.cerebras.ai/v1 |
cheaperinference | CHEAPERINFERENCE_API_KEY | https://api.cheaperinference.com/v1 |
deepseek | DEEPSEEK_API_KEY | https://api.deepseek.com |
gemini | GOOGLE_API_KEY | https://generativelanguage.googleapis.com/v1beta/openai |
groq | GROQ_API_KEY | https://api.groq.com/openai/v1 |
mistral | MISTRAL_API_KEY | https://api.mistral.ai/v1 |
nvidia | NVIDIA_API_KEY | https://integrate.api.nvidia.com/v1 |
ollama | (aucun) | http://localhost:11434/v1 |
openai | OPENAI_API_KEY | https://api.openai.com/v1 |
openrouter | OPENROUTER_API_KEY | https://openrouter.ai/api/v1 |
xai | XAI_API_KEY | https://api.x.ai/v1 |
Pour toute clé non prédéfinie, définissez explicitement baseUrl et apiKeyEnv dans la configuration.
Définissez la clé API du fournisseur actif dans votre environnement, ou dans .env / .env.local à côté de ai-i18n-tools.config.json lorsqu'aucune clé API de fournisseur n'est déjà définie. La CLI affiche les noms de variables qu'elle a lus dans ces fichiers. Consultez Variables d'environnement.
Aucune conservation des données (inférence moins chère)
providers.cheaperinference.zeroDataRetention est facultatif et désactivé par défaut. Activez-le lorsque ce projet doit envoyer des invites uniquement via des fournisseurs qui ne les conservent pas.
"cheaperinference": {
"zeroDataRetention": true,
"translationModels": ["gemini-2.5-flash", "deepseek-v4-flash"]
}Lorsque l'indicateur est activé, chaque requête de chat inclut "zdr": true, et list-models, check-models et suggest-models (y compris l'onglet Modèles du tableau de bord) lisent GET /v1/models?zdr=true. Ce catalogue répertorie les modèles qu'une requête de rétention nulle des données peut utiliser, au prix de la rétention nulle des données. check-models considère un ID manquant dans ce catalogue comme non valide. L'indicateur ne crée pas de route pour un modèle que le catalogue omet. Supprimez cet ID de translationModels, uiModels ou localeModels.
Laissez l'indicateur désactivé lorsque le compte Cheaper Inference ne nécessite pas de rétention nulle des données. Si Protection des données est déjà activée pour le compte, Cheaper Inference refuse toujours un modèle sans route de rétention nulle des données. L'erreur nomme ce modèle. Pour conserver la politique du compte, définissez zeroDataRetention sur true et passez à un modèle du catalogue de rétention nulle des données. Pour conserver le modèle refusé, désactivez la rétention nulle des données sur cette page. La chaîne de secours essaie alors le modèle configuré suivant.
Modèles
Le choix des modèles, la liste de repli, ainsi que suggest-models, check-models, list-models et bench-models sont décrits dans la section Modèles d'IA.
Plusieurs fournisseurs
Lorsque plusieurs fournisseurs sont configurés, définissez la clé provider de niveau supérieur pour sélectionner le fournisseur par défaut. Changez par exécution sans modifier la configuration :
npx ai-i18n-tools translate-docs -P anthropic
npx ai-i18n-tools bench-models -P deepseekChaque bloc de fournisseur peut définir son propre translationModels, ses uiModels et localeModels facultatifs, ses maxTokens, ses temperature et ses requestTimeout (secondes) ou requestTimeoutMs. Un délai d'attente sur le fournisseur remplace le requestTimeout / requestTimeoutMs de niveau supérieur. Un bloc openrouter de niveau supérieur hérité est toujours accepté et migré automatiquement vers providers.openrouter lors du chargement.
Les pricing et modelPricing facultatifs définissent le coût en USD par million de jetons (inputPerMTokens et outputPerMTokens) lorsque le fournisseur omet usage.cost. pricing est la valeur par défaut pour l'ensemble du fournisseur ; une entrée modelPricing la remplace pour un identifiant de modèle. OpenRouter et Cheaper Inference renvoient déjà un coût par appel, laissez-les donc tous deux non définis pour ces fournisseurs. Un coût signalé par le fournisseur est conservé tel quel. Le montant est inclus dans le résumé de la traduction, usage, et Utilisation et coûts.
Exemple exécutable avec quatre fournisseurs sur le même document, incluant des exemples de tarifs : examples/multi-provider.
Références supplémentaires
- Modèles d'IA — liste restreinte classée, liste de repli et commandes de modèle.
- Configuration —
provideretproviders— tableau de préréglages, points de terminaison personnalisés, délais d'expiration des requêtes, tarifs, conservation nulle des données pour Cheaper Inference, comportement spécifique à OpenRouter. - Architecture — Client LLM — fonctionnement interne du repli de modèle, du traitement par lots et du rapport de coûts.
- Variables d'environnement — variables d'environnement de clé d'API et substitutions d'URL de base.