Dokumentation

Erste Schritte mit l10n.dev

l10n.dev ist eine KI-gestützte Lokalisierungsplattform, die für Entwickler und Lokalisierungsteams entwickelt wurde. Sie übersetzt Ihre i18n-Dateien unter Beibehaltung von Schlüsseln, Struktur, Platzhaltern und Pluralformen – von Ihrem KI-Lokalisierungsagenten, Ihrem Terminal, Ihrer CI-Pipeline oder dem Arbeitsbereich im Web. Diese Seite führt Sie durch Ihre erste Übersetzung und zeigt Ihnen, was die Plattform leisten kann, sobald Sie eingerichtet sind.

Schritt 1: Konto erstellen

Bitte nur ein Konto pro Person. Wir bitten Sie höflich, keine doppelten Konten zu erstellen – automatisierte Systeme erkennen und blockieren diese, damit das kostenlose Konto fair und für alle verfügbar bleibt.

Erstellen Sie Ihren API-Schlüssel

Alles außerhalb des Arbeitsbereichs im Web – der KI-Lokalisierungsagent, das CLI, die GitHub Action, die Plugins und die API – authentifiziert sich mit einem API-Schlüssel. Erstellen Sie einen auf der API-Schlüssel Seite und bewahren Sie ihn sicher auf: Sie fügen ihn in Ihre Agentenkonfiguration, Ihre CLI-Konfiguration oder Ihre CI-Geheimnisse ein. Sie können einen Schlüssel jederzeit widerrufen und neu ausstellen.

Schritt 2: Wählen Sie, wie Sie lokalisieren möchten

Es gibt drei Möglichkeiten, l10n.dev zu nutzen. Sie teilen sich die gleiche Übersetzungs-Engine, das Zeichenkontingent, die Lexika und die Sprachanweisungen – wählen Sie also diejenige, die heute zu Ihrem Workflow passt, und kombinieren Sie sie später.

KI-Lokalisierungsagent (MCP)

Wenn Sie Ihren KI-Lokalisierungsagenten mit unserem MCP-Server verbinden, wird er zu einem professionellen Lokalisierungstool. Anstatt selbst Strings zu übersetzen – was Kontext verbraucht und zwischen den Durchläufen abweicht – ruft der Agent l10n.dev als dedizierte Übersetzungs-Engine auf und erhält eine fertige Datei zurück. Es ist, als hätten Sie einen Lokalisierungsexperten in Ihrem Team.

  • Token-effizient: Übersetzte Inhalte gelangen nie in das Kontextfenster Ihres Agenten, sodass Ihr Programmierassistent weiterhin am Code arbeiten kann.
  • Formatgarantien: Schlüssel, Reihenfolge, Platzhalter und Pluralformen kommen intakt zurück – keine defekten JSON-Dateien, die danach bereinigt werden müssen.
  • Persistenter Speicher: Lexika und Sprachanweisungen werden auf unserer Seite gespeichert, sodass die Qualität nicht davon abhängt, woran sich der Agent gerade erinnert.

Die Einrichtung erfolgt über einen einzigen Befehl – hier ist er für Claude Code (Cursor, Windsurf, Copilot, Claude Desktop und Codex werden im Handbuch behandelt):

claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp

Bitten Sie Ihren Agenten dann einfach: "Übersetze src/i18n/en ins Deutsche und Japanische." Er erkennt Ihre Projektstruktur, übersetzt und schreibt die Dateien für Sie.

Lesen Sie das Handbuch zum KI-Lokalisierungsagenten

CLI & GitHub Actions

Das ai-l10n npm-Paket bringt Lokalisierung in Ihr Terminal und Ihre CI/CD-Pipeline. Übersetzen Sie eine Datei manuell während der Entwicklung und übertragen Sie dann genau denselben Befehl in einen Workflow, damit neue Strings lokalisiert werden, bevor sie jemals einen Prüfer erreichen.

  • Erkennung der Projektstruktur: Zeigen Sie auf Ihre Quelldatei und sie findet Ihre vorhandenen Zielsprachen automatisch.
  • Standardmäßig inkrementell: mit translateOnlyNewStrings werden nur hinzugefügte oder geänderte Strings gesendet und abgerechnet.
  • Pipeline-bereit: funktioniert lokal, in GitHub Actions, GitLab CI oder Jenkins gleichermaßen.

Installieren Sie das Paket, speichern Sie Ihren API-Schlüssel und übersetzen Sie Ihre erste Datei:

npm install ai-l10n

npx ai-l10n config --api-key YOUR_API_KEY

# Auto-detects target languages from your project structure
npx ai-l10n translate ./locales/en.json --update

# Or name them explicitly
npx ai-l10n translate ./locales/en.json --languages es,fr,de --update

Um bei jedem Push zu übersetzen, fügen Sie unsere GitHub Action zu Ihrem Workflow hinzu:

name: Auto-translate i18n files

on:
  push:
    branches: [main]
    paths: ['locales/en/**']

permissions:
  contents: write

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: l10n-dev/ai-l10n@v1
        with:
          api-key: ${{ secrets.L10N_API_KEY }}
          config-file: 'ai-l10n.config.json'
          pull-request: false

Lesen Sie das Handbuch zur Lokalisierungsautomatisierung

Arbeitsbereich im Web

Der Arbeitsbereich ist der schnellste Weg, um zu sehen, was der Service produziert – kein API-Schlüssel, keine Installation. Hier verwalten Sie auch Ihre Dateien, Lexika, Anweisungen und Ihr Guthaben.

  1. Laden Sie Ihre i18n-Datei hoch – JSON, YAML, PO, XLIFF, ARB, Markdown oder Klartext.
  2. Wählen Sie die Quellsprache und eine oder mehrere Zielsprachen.
  3. Hängen Sie optional ein Lexikon und Sprachanweisungen an und aktivieren Sie die Übersetzung nur für neue Strings.
  4. Drücken Sie auf Übersetzen, beobachten Sie den Fortschritt und laden Sie dann das Ergebnis herunter oder kopieren Sie es direkt in Ihr Repository.

Öffnen Sie den Arbeitsbereich

Schritt 3: Optimieren Sie die Übersetzungsqualität

Die KI erkennt bereits von Haus aus die umliegenden Schlüssel und die Dateistruktur als Kontext. Diese beiden Funktionen ermöglichen es Ihnen, den Wortschatz und die Markenstimme Ihres Produkts festzulegen, und sie gelten für jeden oben genannten Pfad – Agent, CLI, Arbeitsbereich und API gleichermaßen.

KI-gestütztes Lexikon

Ein Lexikon legt fest, wie Ihre Produktnamen, Funktionsnamen und Fachbegriffe übersetzt werden müssen. Aktivieren Sie die Lexikon-Generierung und l10n.dev erstellt automatisch eines aus Ihren Quell- und übersetzten Inhalten und speichert es als aktives Lexikon für dieses Sprachpaar – damit jede zukünftige Übersetzung markenkonform und konsistent bleibt. Sie können auch Ihr eigenes Lexikon importieren oder eines mit KI generieren.

Lexika verwalten

Sprachanweisungen

Sprachanweisungen sagen der KI, wie sie schreiben soll: formell oder informell, welche Anrede zu verwenden ist, wie mit Markennamen, produktspezifischen Konventionen oder allem anderen, was Ihre Markenstimme definiert, umzugehen ist. Schreiben Sie sie einmal und sie werden auf jede Übersetzung für diese Sprache angewendet.

Sprachanweisungen verwalten

Faustregel: Verwenden Sie ein Lexikon für das, was ein Wort werden muss, und Sprachanweisungen für das, wie der gesamte Text klingen soll.

Was Sie sonst noch bekommen

Inkrementelle Übersetzung

Wir verfolgen Ihre Quell-Strings anhand ihres Inhalts, sodass bei einem erneuten Ausführen einer Übersetzung nur das gesendet wird, was sich tatsächlich geändert hat. Bestehende, geprüfte Übersetzungen bleiben unangetastet, Ihre Git-Diffs bleiben klein und Ihnen werden nur die neuen Texte in Rechnung gestellt. Wir speichern Ihre Inhalte nicht; sie werden nur gehasht, um Änderungen zu erkennen, sodass Ihre Quell-Strings privat bleiben.

165 Sprachen und jedes gängige Format

Übersetzen Sie in 165 Sprachen, einschließlich weniger häufig unterstützter Sprachen, für die menschliche Übersetzer schwer zu finden sind. JSON, YAML, PO, XLIFF, ARB, Markdown, Klartext und OpenAPI-Spezifikationen werden nativ verarbeitet – einschließlich ICU-Nachrichten und vollständigen CLDR-Pluralformen.

Formatgarantie und mehrere LLMs

Jedes Ergebnis wird anhand der Quelle validiert: Wenn ein Platzhalter, ein Schlüssel oder die Struktur verloren geht, wird der Block automatisch erneut versucht. Große Dateien werden in Blöcke unterteilt, die ihren Kontext behalten, und wir betreiben mehrere LLMs, damit jede Sprache und jeder Inhaltstyp das Modell erhält, das ihn am besten verarbeitet.

Integrationen für Ihr gesamtes Team

Lokalisierung ist nicht nur eine Aufgabe für Entwickler. Bringen Sie l10n.dev in die Tools, die Ihr Team bereits verwendet – Plugins für Figma, Obsidian, eine VS Code-Erweiterung, das NPM-Paket, MCP und eine dokumentierte REST-API.

Alle Integrationen durchsuchen

Ihre Privatsphäre ist wichtig

Wir speichern Ihre Übersetzungsdaten nicht. Wenn Sie Dateien im Arbeitsbereich übersetzen, behalten Sie die volle Kontrolle darüber – löschen Sie sie jederzeit.

Ihre Dateien verwalten

Dedizierte Instanz

Wenn Ihr Unternehmen eine isolierte Infrastruktur, eine eigene Datenbank und Speicherung, eigene Modellbereitstellungen oder benutzerdefinierte Compliance-Garantien benötigt, können wir l10n.dev als dedizierte Instanz für Sie betreiben.

Lesen Sie mehr über dedizierte Instanzen

Kostenloses Konto und Pakete

Jedes Konto erhält jeden Monat 10,000 kostenlose Zeichen. Keine Gebühren, keine Kreditkarte erforderlich – das reicht aus, um eine kleine App zu lokalisieren oder die Qualität ordnungsgemäß zu bewerten, bevor Sie sich festlegen.

Wenn Sie mehr als das kostenlose monatliche Kontingent benötigen, können Sie ein Zeichenpaket erwerben, um Ihr Zeichenguthaben zu erhöhen. Verwenden Sie die mit der Bestellung verknüpfte E-Mail-Adresse, um sich anzumelden und auf Ihre Vorteile zuzugreifen.

Verfügbare Zeichenpakete:

  • 100K Characters
    Preis: $4.90
    Übersetzen Sie 100,000 Zeichen.*
  • 1M Characters
    Preis: $14.90
    Übersetzen Sie 1,000,000 Zeichen.*
  • 5M Characters
    Preis: $39.90
    Übersetzen Sie 5,000,000 Zeichen.*

*Jedes Paket ist 90 Tage gültig, und das verbleibende Guthaben wird übertragen, wenn Sie vor Ablauf erneut kaufen.

Alle Pakete und Preise vergleichen

Wie geht es weiter?

Wählen Sie den nächsten Schritt, der zu Ihrer geplanten Arbeitsweise passt – oder übersetzen Sie einfach eine Datei und sehen Sie sich das Ergebnis selbst an.

Warum l10n.dev wählen?

l10n.dev kombiniert die Leistungsfähigkeit von KI mit benutzerfreundlichen Tools, um Ihren Lokalisierungsworkflow zu optimieren. Egal, ob Sie Entwickler oder Teil eines Lokalisierungsteams sind, unsere Plattform sorgt für präzise, effiziente und erschwingliche Übersetzungen, die auf Ihre Bedürfnisse zugeschnitten sind.