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.
DeepL API Key einrichten
Die Translation App sucht in folgender Reihenfolge nach einem DeepL API Key:
Space-Credential prüfen
Gibt es im aktuellen Space ein Credential mit dem exakten Namen deepl-api-key?
Org-Credential prüfen
Gibt es auf Organisationsebene ein Credential mit dem exakten Namen deepl-api-key?
Backend-Variable prüfen
Gibt es eine serverseitige Umgebungsvariable DEEPL_API_KEY?
Die Translation App zeigt Ihnen an, woher der aktuell verwendete DeepL Key stammt (z.B. „Space Credentials” oder „Org Credentials”). So sehen Sie jederzeit, welche Konfiguration aktiv ist.
Key als Benutzer eingeben
Wenn kein DeepL API Key konfiguriert ist, fordert die App Sie direkt zur Eingabe auf:
Geben Sie Ihren DeepL API Key ein und bestätigen Sie. Der Key wird automatisch als Credential mit dem Namen deepl-api-key im aktuellen Space gespeichert.
Dieses Credential können Sie anschließend in den Space-Einstellungen unter dem Bereich Zugangsdaten einsehen, bearbeiten oder löschen.
Key vom Org Admin bereitstellen lassen
Wenn Sie den DeepL API Key nicht selbst verwalten möchten, kann Ihr Org Admin einen Key zentral für die gesamte Organisation bereitstellen. In diesem Fall müssen Sie nichts tun – die Translation App verwendet automatisch den Org-Key.
Details zur org-weiten Einrichtung finden Sie unter Zugangsdaten → DeepL bereitstellen.
Welchen Key verwenden? Wenn Ihr Org Admin bereits einen DeepL Key für die Organisation hinterlegt hat, benötigen Sie keinen eigenen. Ein Space-Credential ist nur sinnvoll, wenn Sie einen separaten Key für diesen Space verwenden möchten (z.B. mit eigenem DeepL-Kontingent).
