LLM-Anbieter
Jede Übersetzungspipeline – translate-ui, translate-docs, translate-json und translate-svg – sendet Text über denselben anbieterunabhängigen Client an ein LLM. Bevor einer dieser Befehle ausgeführt werden kann, konfigurieren Sie mindestens einen Anbieter in ai-i18n-tools.config.json und legen Sie den passenden API-Schlüssel in Ihrer Umgebung oder in .env fest (integrierte Voreinstellungen außer Ollama). init schreibt einen Startblock provider / providers; Sie müssen weiterhin Anmeldeinformationen für die aktive Voreinstellung angeben.
Sie legen einmal in der Konfiguration fest, welcher API-Endpunkt aufgerufen werden soll. Alle Übersetzungsbefehle nutzen diese Einrichtung und denselben SQLite-Cache gemeinsam. Welche Modelle der Anbieter ausprobiert, ist ein separater Schritt: KI-Modelle.
Die CLI löst den aktiven Anbieter aus dem übergeordneten Schlüssel provider (oder dem einzigen Eintrag in providers, wenn nur einer konfiguriert ist). Jeder Anbieterblock listet eine geordnete translationModels-Fallback-Kette auf; integrierte Voreinstellungen erben baseUrl und die API-Schlüssel-Umgebungsvariable automatisch (überschreiben Sie diese bei Bedarf pro Anbieter).
Integrierte Anbieter
Voreingestellte Anbieterschlüssel benötigen nur translationModels – Basis-URL und API-Schlüssel-Umgebungsvariable werden automatisch ausgefüllt:
| Anbieter | API-Schlüssel-Umgebungsvariable | Basis-URL |
|---|---|---|
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 | (none) | 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 |
Für jeden nicht voreingestellten Schlüssel legen Sie baseUrl und apiKeyEnv explizit in der Konfiguration fest.
Legen Sie den API-Schlüssel des aktiven Providers in Ihrer Umgebung fest oder in .env / .env.local neben ai-i18n-tools.config.json, wenn noch kein Provider-API-Schlüssel festgelegt ist. Die CLI gibt die Variablennamen aus, die sie aus diesen Dateien gelesen hat. Siehe Umgebungsvariablen.
Keine Datenspeicherung (günstigere Inferenz)
providers.cheaperinference.zeroDataRetention ist optional und standardmäßig deaktiviert. Aktivieren Sie sie, wenn dieses Projekt Prompts nur über Anbieter senden soll, die diese nicht speichern.
"cheaperinference": {
"zeroDataRetention": true,
"translationModels": ["gemini-2.5-flash", "deepseek-v4-flash"]
}Wenn das Flag aktiviert ist, enthält jede Chat-Anfrage "zdr": true, und list-models, check-models und suggest-models (einschließlich des Tabs „Modelle“ im Dashboard) lesen GET /v1/models?zdr=true. Dieser Katalog listet die Modelle auf, die eine Anfrage mit Null-Datenaufbewahrung zum Preis für Null-Datenaufbewahrung verwenden kann. check-models behandelt eine ID, die in diesem Katalog fehlt, als ungültig. Das Flag erstellt keine Route für ein Modell, das der Katalog nicht enthält. Entfernen Sie diese ID aus translationModels, uiModels oder localeModels.
Lassen Sie das Flag deaktiviert, wenn das Cheaper Inference-Konto keine Null-Datenaufbewahrung erfordert. Wenn Datenschutz für das Konto bereits aktiviert ist, lehnt Cheaper Inference ein Modell ohne Route für Null-Datenaufbewahrung weiterhin ab. Die Fehlermeldung nennt dieses Modell. Um die Kontorichtlinie beizubehalten, setzen Sie zeroDataRetention auf true und wechseln Sie zu einem Modell aus dem Katalog für Null-Datenaufbewahrung. Um das abgelehnte Modell beizubehalten, deaktivieren Sie die Null-Datenaufbewahrung auf dieser Seite. Die Fallback-Kette versucht dann das nächste konfigurierte Modell.
Modelle
Die Auswahl der Modelle, die Fallback-Liste und suggest-models, check-models, list-models und bench-models finden Sie unter KI-Modelle.
Mehrere Anbieter
Wenn mehr als ein Anbieter konfiguriert ist, legen Sie den übergeordneten Schlüssel provider fest, um den Standard auszuwählen. Wechseln Sie pro Lauf, ohne die Konfiguration zu bearbeiten:
npx ai-i18n-tools translate-docs -P anthropic
npx ai-i18n-tools bench-models -P deepseekJeder Provider-Block kann seine eigenen translationModels, optionalen uiModels und localeModels, maxTokens, temperature und requestTimeout (Sekunden) oder requestTimeoutMs definieren. Ein Timeout für den Provider überschreibt das übergeordnete requestTimeout / requestTimeoutMs. Ein veralteter übergeordneter openrouter-Block wird weiterhin akzeptiert und beim Laden automatisch zu providers.openrouter migriert.
Optionale pricing und modelPricing legen USD pro 1 Million Tokens (inputPerMTokens und outputPerMTokens) fest, wenn der Anbieter usage.cost weglässt. pricing ist der anbieterweite Standardwert; ein modelPricing-Eintrag überschreibt ihn für eine Modell-ID. OpenRouter und Cheaper Inference geben bereits Kosten pro Aufruf zurück, lassen Sie daher beide bei diesen Anbietern ungesetzt. Eine vom Anbieter gemeldete Kostenangabe wird wie zurückgegeben beibehalten. Der Betrag ist in der Übersetzungszusammenfassung, usage, und Nutzung & Kosten enthalten.
Ausführbares Beispiel mit vier Anbietern für dasselbe Dokument, inklusive Beispieltarifen: examples/multi-provider.
Weitere Referenzen
- KI-Modelle — priorisierte Auswahlliste, Fallback-Liste und die Modellbefehle.
- Konfiguration —
providerundproviders— vordefinierte Tabelle, benutzerdefinierte Endpunkte, Request-Timeouts, Kostensätze, Null-Datenaufbewahrung bei Cheaper Inference, OpenRouter-spezifisches Verhalten. - Architektur — LLM-Client — interne Funktionsweise von Modell-Fallback, Batch-Verarbeitung und Kostenberichterstattung.
- Umgebungsvariablen — Umgebungsvariablen für API-Schlüssel und Überschreibungen der Basis-URL.