CLI — Modèles et langues
check-models
Synopsis : ai-i18n-tools check-models
Valide chaque ID de modèle configuré par rapport à la liste GET /models du fournisseur actif (appartenance et expiration_date). Nécessite la clé API de ce fournisseur (aucune pour les fournisseurs sans clé comme Ollama). Se termine avec un code d'erreur non nul si un ID configuré est manquant ou a expiré, et respecte le délai d'expiration de la requête résolu (requestTimeout ou requestTimeoutMs sur le fournisseur, sinon la valeur de niveau supérieur). Lorsque le fournisseur renvoie des informations de tarification (par exemple, OpenRouter), affiche également le coût en USD par million de jetons pour l'invite/la complétion. Lorsque providers.cheaperinference.zeroDataRetention est vrai, la vérification utilise GET /v1/models?zdr=true et échoue un ID que le catalogue omet.
Voir aussi : Modèles d'IA, Fournisseurs de LLM
list-models
Synopsis : ai-i18n-tools list-models
Liste tous les modèles que le fournisseur actif annonce via sa liste GET /models (trié par ID ; le fournisseur actif suit la clé provider de la configuration, à remplacer par -P / --provider). Nécessite la clé API de ce fournisseur (aucune pour les fournisseurs sans clé comme Ollama). Lorsque le fournisseur renvoie des informations de tarification (par exemple, OpenRouter), affiche également le coût en USD par million de jetons pour l'invite/la complétion, et marque les entrées au-delà de expiration_date. Lorsque providers.cheaperinference.zeroDataRetention est vrai, la liste est GET /v1/models?zdr=true.
Options clés : -P / --provider
Voir aussi : Modèles d'IA, Fournisseurs de LLM
suggest-models
Synopsis : ai-i18n-tools suggest-models [--quality | --price] [--top <n>] [--json] [--apply] [--list] [--max-price <usd>] [--min-delta <points>] [--refresh]
Classe les modèles de chat du fournisseur actif et affiche les meilleurs (8 par défaut). Les colonnes du tableau, dans l'ordre, sont le rang, l'ID du modèle, l'indice (score de qualité multiplié par 100, une décimale), le ChrF mesuré de languagebench, le score Arena mesuré, le prix d'entrée, le prix de sortie, le prix combiné en USD par million de jetons, et le niveau de la frontière. Une mesure manquante est —. La commande nécessite la clé API de ce fournisseur (aucune pour les fournisseurs sans clé comme Ollama). Le fournisseur actif suit la configuration provider ; remplacez-la par -P / --provider.
Les candidats proviennent de la liste GET /models du fournisseur. Lorsque providers.cheaperinference.zeroDataRetention est vrai, cette requête est GET /v1/models?zdr=true. Les lignes expirées et les lignes non-chat (embeddings, parole, image, vidéo, modération, rerankers) sont exclues. Si cette requête de catalogue échoue, la commande se termine avec le code 1.
L'indice est uniquement basé sur la qualité : ChrF de languagebench et score Arena. Le prix ne fait pas partie de l'indice. --quality est la valeur par défaut. Il trie par indice, puis par prix combiné le moins cher lorsque deux modèles affichent le même indice. --price liste la frontière de Pareto qualité-prix, du moins cher au plus cher. Un modèle est dominé lorsqu'un autre modèle ne coûte pas plus cher et a au moins le même indice, et est strictement moins cher ou strictement plus élevé sur l'indice. Une égalité exacte sur le prix combiné et l'indice partage le niveau. Les modèles non dominés sont de niveau 1, puis de niveau 2, et ainsi de suite. Le niveau est cette profondeur, pas la distance par rapport au meilleur indice. Les modèles sans prix, puis les modèles en dessous du seuil de qualité, suivent la frontière. Passer les deux drapeaux est une erreur. Ne passer aucun des deux signifie qualité. Les pondérations facultatives modelSuggestion dans la configuration remplacent le mélange ChrF/Arena et le seuil de qualité de l'un ou l'autre profil. Voir Configuration. Le même classement est utilisé par l'onglet Modèles du tableau de bord.
ChrF est la moyenne des lignes translation_from et translation_to de languagebench dont la métrique est chrf, limitée aux sourceLocale et targetLocales de ce projet. Les paramètres régionaux correspondent à un code de langue languagebench (le sous-tag principal, avec quelques alias tels que pt-BR vers pt et zh-Hant vers zh et yue). Un ensemble vide utilise en. Arena est l'Arena Score global de LMArena, pas Elo.
Le prix combiné est de (3 × input + output) / 4 USD par million de jetons. Sa source est résolue dans cet ordre : un taux de catalogue non nul, puis les taux d'entrée et de sortie de models.dev, puis le chiffre de coût unique de languagebench. Un prix de catalogue de 0 signifie non tarifé, pas gratuit. Un prix inconnu ne modifie pas l'indice. Sur --quality, il est trié en dernier parmi les indices égaux. Sur --price, un modèle non tarifé qui dépasse le seuil vient après chaque niveau de frontière.
Un ChrF manquant est trié en dessous du seuil de qualité. Les valeurs de remplacement 0.35 et 0.45 utilisées lorsque ChrF ou Arena est manquant n'affectent que l'indice ; le tableau affiche — à la place. La colonne frontier est 1 pour un modèle tarifé non dominé qui dépasse le seuil, 2 pour le niveau suivant, et — lorsque le modèle n'a pas de prix, est en dessous du seuil, ou est un alias. Deux ID qui partagent ChrF, le score Arena, le prix d'entrée et le prix de sortie sont des alias. L'ID le plus court est conservé, et un ID sans date l'emporte sur un ID daté (preview-06-05, 20241022). Les lignes d'alias restent dans le classement complet et sont exclues du tableau, de --json et de --apply. --list les affiche toujours. Lorsque les lignes affichées incluent un modèle dominé, une ligne sous le tableau nomme le modèle de niveau 1 qui le surpasse.
--quality place les modèles qui dépassent le seuil en premier, puis ceux avec un indice plus élevé, puis ceux avec un prix combiné moins cher. --top (par défaut 8, un entier d'au moins 1) limite le tableau, le fragment --json et --apply ensemble, après les filtres ci-dessous.
--list affiche les mêmes colonnes pour les translationModels configurés du fournisseur actif, dans cet ordre, et ignore --top. La colonne de rang correspond toujours à la place de chaque modèle dans le classement complet. Un identifiant configuré manquant dans le catalogue, expiré ou qui n'est pas un modèle de chat est toujours listé, avec — pour les mesures. --list ne peut pas être combiné avec --apply.
Les lignes d'alias sont supprimées en premier, sauf avec --list. --max-price conserve ensuite les modèles dont le prix combiné par million de jetons est inférieur ou égal à ce nombre d'USD. Un modèle sans prix combiné est exclu. --min-delta parcourt ensuite les lignes restantes et ne conserve un modèle que si son indice diffère du modèle précédemment conservé d'au moins ce nombre de points. Le premier modèle restant est toujours conservé. Un delta de 0 ne supprime pas de lignes. Les lignes sans indice sont exclues lorsque le delta est supérieur à 0. Les numéros de rang restent ceux de la liste complète. Avec --list, le parcours suit l'ordre translationModels et conserve les alias. Les deux filtres s'appliquent également à --json et --apply. Pour une liste de qualité qui sera appliquée, --max-price conserve une solution de repli dans un budget et --min-delta supprime une petite étape d'indice. Une ligne dominée sous le plafond peut rester ; la colonne de la frontière et la ligne sous le tableau l'indiquent. L'onglet Modèles a les deux mêmes contrôles et omet également les alias.
--json écrit cet objet sur stdout (à coller dans le bloc fournisseur) et envoie le tableau ainsi que le pied de page d'attribution sur stderr :
{
"translationModels": ["model-a", "model-b"]
}--apply copie la configuration actuelle vers un ai-i18n-tools.config.{timestamp}.backup.json frère (ou {name}.{timestamp}.backup.json lorsque -c nomme un autre fichier), puis remplace providers.<active>.translationModels par ces ID. Une collision de noms ajoute -2, -3, et ainsi de suite avant .backup.json. Si la copie échoue, le fichier de configuration reste inchangé. uiModels et localeModels restent inchangés. Les scores ne sont pas écrits dans le fichier de configuration. Le bouton Mettre à jour la configuration du tableau de bord écrit la même sauvegarde.
Les données de benchmark sont mises en cache à <cacheDir>/benchmark-scores.json (généralement .translation-cache/benchmark-scores.json) pendant sept jours. Les jeux de données bruts sont téléchargés à l'exécution et ne sont pas inclus dans le package. --refresh retélécharge languagebench, Arena et models.dev. Une source qui échoue pendant --refresh n'est pas remplie à partir du cache précédent. Sans --refresh, un téléchargement échoué réutilise la tranche mise en cache. Si l'un de languagebench ou Arena échoue, la commande classe avec l'autre et indique quelle source a échoué. Si les deux échouent, elle se termine avec le code 1. Un échec de models.dev laisse les prix du catalogue en place. Le tableau de bord n'a pas de contrôle d'actualisation ; exécutez --refresh depuis la CLI, puis rechargez l'onglet Modèles.
Le pied de page attribue languagebench (CC BY-SA 4.0), l'Arena Score de LMArena (CC BY 4.0) et models.dev (MIT).
Options clés : --quality, --price, --top, --json, --apply, --list, --max-price, --min-delta, --refresh, -P / --provider
Voir aussi : Modèles d'IA, Onglet Modèles
bench-models
Synopsis : ai-i18n-tools bench-models [--model <ids>] [--text <text> | --file <path>] [--source <locale>] [--target <locale>]
Évalue chaque modèle configuré en traduisant un échantillon de manière isolée (client à modèle unique, pas de chaîne de secours). Affiche un tableau avec l'ID du modèle, les jetons d'entrée/sortie, le temps de traduction réel, et le coût en USD (— pour les fournisseurs qui ne signalent pas le coût), ainsi qu'une ligne de totaux et les échecs par modèle.
Les modèles sont par défaut l'union des ID translationModels, uiModels et localeModels du fournisseur actif (à remplacer par --model) ; l'échantillon est par défaut un bloc Markdown anglais intégré (à remplacer par --text / --file) ; la source/cible sont par défaut la configuration sourceLocale et la première locale cible docs[], en revenant à la locale targetLocales de niveau supérieur (à remplacer par --source / --target). Exécute les modèles en parallèle, limité par la configuration concurrency (par défaut 4) ; chaque modèle est toujours chronométré individuellement. Nécessite la clé API du fournisseur actif.
Options clés : --model, --text, --file, --source, --target
Voir aussi : Modèles d'IA
list-languages
Synopsis : ai-i18n-tools list-languages [search]
Liste le catalogue des langues d'interface utilisateur (data/ui-languages-complete.json) sous forme de tableau lisible (code, direction du texte, nom anglais, nom natif). Ne nécessite aucune configuration ni clé API. Passez un terme search facultatif pour ne conserver que les entrées dont le code, le nom natif, le nom anglais ou la direction le contiennent (insensible à la casse), par exemple list-languages portuguese, list-languages rtl, list-languages zh.