Verbinde deine Engine

Die Lingo.dev CLI verbindet deine Codebase über ein einziges Konfigurationsfeld mit einer Lokalisierungs-Engine. Jeder lingo.dev run-Aufruf läuft über deine Engine – und wendet dabei automatisch deine Markenstimme, dein Glossar, deine Anweisungen und deine Modellkonfiguration an. Keine Codeänderungen, keine neuen Abhängigkeiten.

Was sich ändert#

	Vorher	Nachher
Übersetzungspipeline	Standard-Pipeline von Lingo.dev	Deine Lokalisierungs-Engine
Markenstimme	Keine	Pro Zielsprache angewendet
Glossar	Keines	Semantisch pro Anfrage abgeglichen
Anweisungen	Keine	Pro Zielsprache enthalten
Modellauswahl	Lingo.dev-Standard	Deine Modellkonfiguration mit Fallbacks
Qualitätsprüfung	Keine	Deine konfigurierten KI-Bewerter laufen automatisch

Einrichtung#

engineId zu i18n.json hinzufügen (optional)

Wenn du eine bestimmte Engine ansteuern möchtest, füge deiner i18n.json-Konfiguration das Feld engineId hinzu. Deine Engine-ID findest du im Dashboard – sie beginnt mit eng_ (z. B. eng_SxjMwMsfOIsvV1wh).

json

{
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "json": {
      "include": ["[locale]/messages.json"]
    }
  },
  "engineId": "eng_SxjMwMsfOIsvV1wh"
}

Alles andere in deiner Konfiguration bleibt unverändert – Quell-Sprache, Ziele, Buckets. Wenn du engineId weglässt, verwendet die CLI die Standard-Engine deiner Organisation.

API-Schlüssel festlegen

Die CLI authentifiziert sich mit deinem Lingo.dev-API-Schlüssel. Lege ihn als Umgebungsvariable fest:

bash

export LINGO_API_KEY="your-api-key"

Oder speichere ihn dauerhaft in ~/.lingodotdevrc:

ini

[auth.vnext]
apiKey = your-api-key

Erstelle einen API-Schlüssel auf der Seite API Keys im Dashboard.

Übersetzungen ausführen

bash

lingo.dev run

Die CLI sendet Übersetzungsanfragen an deine Engine und schreibt die Ergebnisse zurück in deine Sprachdateien – dabei werden automatisch deine Markenstimme, dein Glossar, deine Anweisungen und deine Modellkonfiguration angewendet.

Konfigurationsreferenz#

i18n.json#

Feld	Beschreibung
`engineId`	Optional. Deine Engine-ID (`eng_...`). Wenn sie fehlt, wird die Standard-Engine deiner Organisation verwendet.

Alle anderen i18n.json-Felder (version, locale, buckets) funktionieren genauso wie in der Standardkonfiguration der CLI.

Umgebungsvariablen#

Variable	Erforderlich	Standard	Beschreibung
`LINGO_API_KEY`	Ja	-	Dein Lingo.dev-API-Schlüssel
`LINGO_API_URL`	Nein	`https://api.lingo.dev`	Benutzerdefinierte API-Basis-URL (für Self-Hosting oder Staging)

Was dich erwartet#

Jede Übersetzung, die die CLI erstellt, durchläuft die vollständige Pipeline deiner Engine:

Markenstimme steuert Ton und Formalität pro Sprache
Glossareinträge stellen durch semantisches Matching die korrekte Terminologie sicher
Anweisungen wenden sprachspezifische Regeln pro Sprache an
Modellkonfigurationen wählen das passende LLM mit automatischen Fallbacks aus
KI-Bewerter bewerten die Qualität nach jeder Anfrage automatisch

Übersetzungen erscheinen in Reports mit dem Trigger-Typ api – zusammen mit Anfragen aus der API und aus Integrationen.

Nächste Schritte#

API Keys

Erstelle den API-Schlüssel für die CLI-Authentifizierung

Brand Voices

Lege fest, wie deine Engine pro Sprache übersetzt

Glossaries

Richte Terminologieregeln vor deinem ersten Lauf ein

API Referenz

Nutze dieselbe Engine programmatisch

Was sich ändert#

	Vorher	Nachher
Übersetzungspipeline	Standard-Pipeline von Lingo.dev	Deine Lokalisierungs-Engine
Markenstimme	Keine	Pro Zielsprache angewendet
Glossar	Keines	Semantisch pro Anfrage abgeglichen
Anweisungen	Keine	Pro Zielsprache enthalten
Modellauswahl	Lingo.dev-Standard	Deine Modellkonfiguration mit Fallbacks
Qualitätsprüfung	Keine	Deine konfigurierten KI-Bewerter laufen automatisch

Einrichtung#

engineId zu i18n.json hinzufügen (optional)

json

{
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de"]
  },
  "buckets": {
    "json": {
      "include": ["[locale]/messages.json"]
    }
  },
  "engineId": "eng_SxjMwMsfOIsvV1wh"
}

Alles andere in deiner Konfiguration bleibt unverändert – Quell-Sprache, Ziele, Buckets. Wenn du engineId weglässt, verwendet die CLI die Standard-Engine deiner Organisation.

API-Schlüssel festlegen

Die CLI authentifiziert sich mit deinem Lingo.dev-API-Schlüssel. Lege ihn als Umgebungsvariable fest:

bash

export LINGO_API_KEY="your-api-key"

Oder speichere ihn dauerhaft in ~/.lingodotdevrc:

ini

[auth.vnext]
apiKey = your-api-key

Erstelle einen API-Schlüssel auf der Seite API Keys im Dashboard.

Übersetzungen ausführen

bash

lingo.dev run

Konfigurationsreferenz#

i18n.json#

Feld	Beschreibung
`engineId`	Optional. Deine Engine-ID (`eng_...`). Wenn sie fehlt, wird die Standard-Engine deiner Organisation verwendet.

Alle anderen i18n.json-Felder (version, locale, buckets) funktionieren genauso wie in der Standardkonfiguration der CLI.

Umgebungsvariablen#

Variable	Erforderlich	Standard	Beschreibung
`LINGO_API_KEY`	Ja	-	Dein Lingo.dev-API-Schlüssel
`LINGO_API_URL`	Nein	`https://api.lingo.dev`	Benutzerdefinierte API-Basis-URL (für Self-Hosting oder Staging)

Was dich erwartet#

Jede Übersetzung, die die CLI erstellt, durchläuft die vollständige Pipeline deiner Engine:

Markenstimme steuert Ton und Formalität pro Sprache
Glossareinträge stellen durch semantisches Matching die korrekte Terminologie sicher
Anweisungen wenden sprachspezifische Regeln pro Sprache an
Modellkonfigurationen wählen das passende LLM mit automatischen Fallbacks aus
KI-Bewerter bewerten die Qualität nach jeder Anfrage automatisch

Übersetzungen erscheinen in Reports mit dem Trigger-Typ api – zusammen mit Anfragen aus der API und aus Integrationen.

Nächste Schritte#

API Keys

Erstelle den API-Schlüssel für die CLI-Authentifizierung

Brand Voices

Lege fest, wie deine Engine pro Sprache übersetzt

Glossaries

Richte Terminologieregeln vor deinem ersten Lauf ein

API Referenz

Nutze dieselbe Engine programmatisch