CLI — Modelle und Sprachen
check-models
Zusammenfassung: ai-i18n-tools check-models
Validiert jede konfigurierte Modell-ID anhand der GET /models-Liste des aktiven Anbieters (Mitgliedschaft und expiration_date). Erfordert den API-Schlüssel dieses Anbieters (keiner für schlüssellose Anbieter wie Ollama). Beendet sich mit einem Fehlercode ungleich Null, wenn eine konfigurierte ID fehlt oder abgelaufen ist, und berücksichtigt das aufgelöste Anforderungs-Timeout (requestTimeout oder requestTimeoutMs beim Anbieter, andernfalls den Wert der obersten Ebene). Wenn der Anbieter Preise zurückgibt (z. B. OpenRouter), werden auch USD pro 1 Million Tokens für Prompt/Completion angezeigt. Wenn providers.cheaperinference.zeroDataRetention wahr ist, verwendet die Überprüfung GET /v1/models?zdr=true und schlägt eine ID fehl, die der Katalog weglässt.
Siehe auch: KI-Modelle, LLM-Anbieter
list-models
Zusammenfassung: ai-i18n-tools list-models
Listet jedes Modell auf, das der aktive Anbieter über seine GET /models-Liste bewirbt (sortiert nach ID; der aktive Anbieter folgt dem Konfigurationsschlüssel provider, Überschreibung mit -P / --provider). Erfordert den API-Schlüssel dieses Anbieters (keiner für schlüssellose Anbieter wie Ollama). Wenn der Anbieter Preise zurückgibt (z. B. OpenRouter), werden auch USD pro 1 Million Tokens für Prompt/Completion angezeigt und Einträge markiert, die expiration_date überschreiten. Wenn providers.cheaperinference.zeroDataRetention wahr ist, ist die Liste GET /v1/models?zdr=true.
Schlüsseloptionen: -P / --provider
Siehe auch: KI-Modelle, LLM-Anbieter
suggest-models
Zusammenfassung: ai-i18n-tools suggest-models [--quality | --price] [--top <n>] [--json] [--apply] [--list] [--max-price <usd>] [--min-delta <points>] [--refresh]
Rangieren Sie die Chat-Modelle des aktiven Anbieters und geben Sie die besten (Standard 8) aus. Die Tabellenspalten sind der Reihe nach: Rang, Modell-ID, Index (Qualitätsbewertung mal 100, eine Dezimalstelle), gemessener languagebench ChrF, gemessener Arena Score, Eingabepreis, Ausgabepreis, Blended Price in USD pro 1 Million Tokens und Frontier-Tier. Eine fehlende Messung ist —. Der Befehl benötigt den API-Schlüssel dieses Anbieters (keinen für schlüssellose Anbieter wie Ollama). Der aktive Anbieter folgt der Konfiguration provider; überschreiben Sie diese mit -P / --provider.
Kandidaten stammen aus der GET /models-Liste des Anbieters. Wenn providers.cheaperinference.zeroDataRetention wahr ist, ist diese Anforderung GET /v1/models?zdr=true. Abgelaufene Zeilen und Nicht-Chat-Zeilen (Embeddings, Sprache, Bild, Video, Moderation, Reranker) werden weggelassen. Wenn diese Kataloganforderung fehlschlägt, beendet sich der Befehl mit dem Exit-Code 1.
Der Index ist ausschließlich Qualität: languagebench ChrF und Arena Score. Der Preis ist nicht Teil des Index. --quality ist die Standardeinstellung. Es sortiert nach Index, dann nach günstigerem Blended Price, wenn zwei Modelle denselben Index aufweisen. --price listet die Qualitäts-Preis-Pareto-Frontier, die günstigsten zuerst. Ein Modell ist dominiert, wenn ein anderes Modell nicht mehr kostet und mindestens denselben Index hat und entweder strikt günstiger oder strikt höher im Index ist. Ein exakter Gleichstand bei Blended Price und Index teilt sich den Tier. Nicht-dominierte Modelle sind Tier 1, dann Tier 2 und so weiter. Der Tier ist diese Tiefe, nicht der Abstand zum besten Index. Modelle ohne Preis, dann Modelle unterhalb der Qualitätsuntergrenze, folgen der Frontier. Das Übergeben beider Flags ist ein Fehler. Keines davon zu übergeben bedeutet Qualität. Optionale modelSuggestion-Gewichtungen in der Konfiguration ersetzen den ChrF/Arena-Mix und die Qualitätsuntergrenze beider Profile. Siehe Konfiguration. Dieselbe Rangliste wird vom Dashboard-Tab „Modelle“ verwendet.
ChrF ist der Mittelwert der languagebench-Zeilen translation_from und translation_to, deren Metrik chrf ist, begrenzt auf die sourceLocale und targetLocales dieses Projekts. Gebietsschemas werden einem languagebench-Sprachcode zugeordnet (dem primären Subtag, mit einigen Aliasen wie pt-BR zu pt und zh-Hant zu zh und yue). Ein leeres Set verwendet en. Arena ist der LMArena-Gesamt-Arena-Score, nicht Elo.
Der Blended Price beträgt (3 × input + output) / 4 USD pro 1 Million Tokens. Seine Quelle wird in dieser Reihenfolge aufgelöst: ein nicht-null Katalogpreis, dann models.dev Eingabe- und Ausgabepreise, dann die einzelne Kostenangabe von languagebench. Ein Katalogpreis von 0 ist unbepreist, nicht kostenlos. Ein unbekannter Preis ändert den Index nicht. Bei --quality sortiert es zuletzt unter gleichen Indizes. Bei --price kommt ein unbepreistes Modell, das die Untergrenze überschreitet, nach jedem Frontier-Tier.
Ein fehlender ChrF sortiert unterhalb der Qualitätsuntergrenze. Die Platzhalterwerte 0.35 und 0.45, die verwendet werden, wenn ChrF oder Arena fehlen, beeinflussen nur den Index; die Tabelle gibt stattdessen — aus. Die Spalte frontier ist 1 für ein undominiertes, bepreistes Modell, das die Untergrenze überschreitet, 2 für den nächsten Tier und —, wenn das Modell keinen Preis hat, unterhalb der Untergrenze liegt oder ein Alias ist. Zwei IDs, die ChrF, Arena Score, Eingabepreis und Ausgabepreis teilen, sind Aliase. Die kürzere ID wird beibehalten, und eine ID ohne Datum gewinnt gegenüber einer datierten (preview-06-05, 20241022). Alias-Zeilen bleiben in der vollständigen Rangliste und werden aus der Tabelle, --json und --apply weggelassen. --list zeigt sie immer noch an. Wenn die ausgegebenen Zeilen ein dominiertes Modell enthalten, benennt eine Zeile unter der Tabelle das Tier-1-Modell, das es übertrifft.
--quality platziert Modelle, die die Untergrenze überschreiten, zuerst, dann höhere Indizes, dann einen günstigeren Blended Price. --top (Standard 8, eine Ganzzahl von mindestens 1) begrenzt die Tabelle, das Fragment --json und --apply zusammen, nach den unten stehenden Filtern.
--list gibt dieselben Spalten für die konfigurierten translationModels des aktiven Providers in dieser Reihenfolge aus und ignoriert --top. Die Rangspalte ist weiterhin der Platz jedes Modells im Gesamtranking. Eine konfigurierte ID, die im Katalog fehlt, abgelaufen ist oder kein Chat-Modell ist, wird weiterhin mit — für Messwerte aufgelistet. --list kann nicht mit --apply kombiniert werden.
Alias-Zeilen werden zuerst entfernt, außer mit --list. --max-price behält dann Modelle, deren Blended Price pro 1 Million Tokens kleiner oder gleich dieser Anzahl von USD ist. Ein Modell ohne Blended Price wird weggelassen. --min-delta durchläuft dann die verbleibenden Zeilen und behält ein Modell nur, wenn sein Index sich vom zuvor behaltenen Modell um mindestens so viele Punkte unterscheidet. Das erste verbleibende Modell wird immer behalten. Ein Delta von 0 löscht keine Zeilen. Zeilen ohne Index werden weggelassen, wenn das Delta größer als 0 ist. Die Rangnummern bleiben die der vollständigen Liste. Mit --list folgt der Durchlauf der translationModels-Reihenfolge und behält Aliase bei. Beide Filter gelten auch für --json und --apply. Für eine Qualitätsliste, die angewendet wird, behält --max-price einen Fallback innerhalb eines Budgets und --min-delta lässt einen kleinen Indexschritt fallen. Eine dominierte Zeile unter der Obergrenze kann bleiben; die Frontier-Spalte und die Zeile unter der Tabelle zeigen dies an. Der Tab „Modelle“ hat dieselben beiden Steuerelemente und lässt auch Aliase weg.
--json schreibt dieses Objekt in stdout (fügen Sie es in den Provider-Block ein) und sendet die Tabelle sowie die Attributions-Fußzeile an stderr:
{
"translationModels": ["model-a", "model-b"]
}--apply kopiert die aktuelle Konfiguration in eine gleichgeordnete ai-i18n-tools.config.{timestamp}.backup.json (oder {name}.{timestamp}.backup.json, wenn -c eine andere Datei benennt) und ersetzt dann providers.<active>.translationModels durch diese IDs. Eine Namenskollision fügt -2, -3 und so weiter vor .backup.json hinzu. Wenn das Kopieren fehlschlägt, bleibt die Konfigurationsdatei unverändert. uiModels und localeModels bleiben unverändert. Scores werden nicht in die Konfigurationsdatei geschrieben. Die Schaltfläche Konfiguration aktualisieren des Dashboards schreibt dasselbe Backup.
Benchmark-Daten werden für sieben Tage unter <cacheDir>/benchmark-scores.json (normalerweise .translation-cache/benchmark-scores.json) zwischengespeichert. Die Rohdatensätze werden zur Laufzeit heruntergeladen und sind nicht im Paket enthalten. --refresh lädt languagebench, Arena und models.dev erneut herunter. Eine Quelle, die während --refresh fehlschlägt, wird nicht aus dem vorherigen Cache gefüllt. Ohne --refresh verwendet ein fehlgeschlagener Download den zwischengespeicherten Slice erneut. Wenn languagebench oder Arena fehlschlägt, rankt der Befehl mit dem anderen und gibt an, welche Quelle fehlgeschlagen ist. Wenn beide fehlschlagen, wird mit Exit-Code 1 beendet. Ein models.dev-Fehler lässt die Katalogpreise unverändert. Das Dashboard hat keine Aktualisierungssteuerung; führen Sie --refresh über die CLI aus und laden Sie dann den Tab „Modelle“ neu.
Die Fußzeile nennt languagebench (CC BY-SA 4.0), den LMArena Arena Score (CC BY 4.0) und models.dev (MIT).
Wichtige Optionen: --quality, --price, --top, --json, --apply, --list, --max-price, --min-delta, --refresh, -P / --provider
Siehe auch: KI-Modelle, Registerkarte „Modelle“
bench-models
Zusammenfassung: ai-i18n-tools bench-models [--model <ids>] [--text <text> | --file <path>] [--source <locale>] [--target <locale>]
Benchmarkt jedes konfigurierte Modell, indem es eine Probe in Isolation übersetzt (Single-Modell-Client, keine Fallback-Kette). Gibt eine Tabelle mit Modell-ID, Eingabe-/Ausgabetoken, Wanduhr-Übersetzungszeit und USD-Kosten aus (— für Provider, die keine Kosten melden), sowie eine Zeile mit den Gesamtwerten und pro-Modell-Fehlern.
Modelle standardmäßig auf die Vereinigung der translationModels-, uiModels- und localeModels-IDs des aktiven Providers (Überschreiben mit --model); die Probe standardmäßig auf einen eingebauten englischen Markdown-Block (Überschreiben mit --text / --file); Quelle/Ziel standardmäßig auf die Konfiguration sourceLocale und die erste docs[]-Ziel-Lokale, Fallback auf die oberste Ebene targetLocales (Überschreiben mit --source / --target). Führt Modelle parallel aus, begrenzt durch die Konfiguration concurrency (Standard 4); jedes Modell wird dennoch individuell zeitlich bemessen. Erfordert den API-Schlüssel des aktiven Providers.
Schlüsseloptionen: --model, --text, --file, --source, --target
Siehe auch: KI-Modelle
list-languages
Zusammenfassung: ai-i18n-tools list-languages [search]
Listet den mitgelieferten UI-Sprachenkatalog (data/ui-languages-complete.json) als lesbare Tabelle (Code, Textrichtung, englischer Name, natürlicher Name) auf. Benötigt keine Konfiguration oder API-Schlüssel. Optional kann ein search-Term übergeben werden, um nur Einträge zu behalten, deren Code, natürlicher Name, englischer Name oder Richtung ihn enthalten (groß-/kleinschreibungsunabhängig), z. B. list-languages portuguese, list-languages rtl, list-languages zh.