> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localmind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Übersetzung

> Texte und Dokumente mit DeepL übersetzen – direkt in Localmind.

Die Translation App übersetzt Texte und Dokumente mithilfe der DeepL-API. Für die Nutzung ist ein gültiger **DeepL-API-Key** erforderlich, der entweder vom Benutzer selbst oder zentral vom Org Admin bereitgestellt wird.

Du findest die App in deinem Space in der Sidebar unterhalb der Standard-Ressourcen als **Übersetzung**.

## DeepL-API-Key einrichten

Die Translation App sucht in folgender Reihenfolge nach einem DeepL-API-Key:

<Steps>
  <Step title="Space-Credential prüfen">
    Gibt es im aktuellen Space ein Credential mit dem exakten Namen `deepl-api-key`?
  </Step>

  <Step title="Org-Credential prüfen">
    Gibt es auf Organisationsebene ein Credential mit dem exakten Namen `deepl-api-key`?
  </Step>

  <Step title="Backend-Variable prüfen">
    Gibt es eine serverseitige Umgebungsvariable `DEEPL_API_KEY`?
  </Step>
</Steps>

Sobald ein Key auf einer Ebene gefunden wird, wird dieser verwendet – die nachfolgenden Ebenen werden nicht mehr geprüft. Ein Space-Credential hat also immer Vorrang vor einem Org-Credential.

<Info>
  Die Translation App zeigt dir an, woher der aktuell verwendete DeepL-Key stammt (z.B. „Space Credentials" oder „Org Credentials"). So siehst du jederzeit, welche Konfiguration aktiv ist.
</Info>

## Key als Benutzer eingeben

Wenn kein DeepL-API-Key konfiguriert ist, fordert die App dich direkt zur Eingabe auf:

<Frame>
  <img src="https://mintcdn.com/localmind/qkWmTmAXiTLjXXh7/footage/deepluser.png?fit=max&auto=format&n=qkWmTmAXiTLjXXh7&q=85&s=c3c6f193a101bddd7e73bd481294dd1f" alt="Translation App ohne konfigurierten DeepL-API-Key – Eingabeaufforderung" width="1708" height="1284" data-path="footage/deepluser.png" />
</Frame>

Gib deinen DeepL-API-Key ein und bestätige. Der Key wird automatisch als Credential mit dem Namen `deepl-api-key` im aktuellen Space gespeichert.

Dieses Credential kannst du anschließend in den [Org-Einstellungen unter Zugangsdaten](/settings/organization/Zugangsdaten) (Feld „Bereich": dein Space) einsehen, bearbeiten oder löschen.

## Key vom Org Admin bereitstellen lassen

Wenn du den DeepL-API-Key nicht selbst verwalten möchtest, kann dein Org Admin einen Key zentral für die gesamte Organisation bereitstellen. In diesem Fall musst du nichts tun – die Translation App verwendet automatisch den Org-Key.

Details zur org-weiten Einrichtung findest du unter [Zugangsdaten → DeepL bereitstellen](/settings/organization/Zugangsdaten#deepl-für-die-translation-app-bereitstellen).

<Tip>
  **Welchen Key verwenden?** Wenn dein Org Admin bereits einen DeepL-Key für die Organisation hinterlegt hat, benötigst du keinen eigenen. Ein Space-Credential ist nur sinnvoll, wenn du einen separaten Key für diesen Space verwenden möchtest (z.B. mit eigenem DeepL-Kontingent).
</Tip>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Zugangsdaten (Admin)" icon="key" href="/settings/organization/Zugangsdaten">
    DeepL-Key als Org Admin zentral bereitstellen und Credentials verwalten.
  </Card>

  <Card title="Dokumentenanalyse" icon="file-search" href="/apps/Document-Analysis">
    Dokumente inhaltlich auswerten – mit Vorlagen wie Management-Zusammenfassung oder Vertragsprüfung.
  </Card>

  <Card title="Dokumentenextraktion" icon="table" href="/apps/Document-Extraction">
    Strukturierte Felder aus Dokumenten ziehen – mit Konfidenz, Quellenbeleg und Review.
  </Card>

  <Card title="Dokumente" icon="file-text" href="/core-functions/Dokumente">
    Dokumente hochladen und als Datenquelle in deinem Space nutzen.
  </Card>
</CardGroup>