Api zugänge

CogiTranslator übersetzt nicht selbst, sondern schickt Ihre Texte an einen externen Übersetzungsdienst. Dafür benötigt das Plugin einen gültigen API-Zugang.

DeepL

DeepL bietet zwei Abo-Varianten, die unterschiedlich angesprochen werden müssen:

Abo	Zeichenlimit	Einstellung im Plugin
DeepL API Free	500.000 Zeichen/Monat kostenlos	Schalter „Kostenlose API" muss aktiv sein
DeepL API Pro	kostenpflichtig, nach Verbrauch	Schalter „Kostenlose API" muss deaktiviert sein

Ist dieser Schalter falsch gesetzt, schlagen alle DeepL-Übersetzungen mit einem Verbindungsfehler fehl, weil das Plugin die falsche DeepL-Adresse anspricht.

Den API-Schlüssel erhalten Sie in Ihrem DeepL-Konto und tragen ihn unter Einstellungen → Erweiterungen → Meine Erweiterungen → CogiTranslator → Konfiguration, Karte „DeepL - Einstellungen", Feld „Deepl API Schlüssel" ein.

ChatGPT

Für ChatGPT benötigen Sie einen API-Schlüssel aus Ihrem OpenAI-Konto. Er wird unter der Karte „ChatGPT - Einstellungen", Feld „ChatGPT API Schlüssel" hinterlegt. Welches Modell dabei zum Einsatz kommt, wählen Sie im Feld „ChatGPT Standard-Modell" — Details dazu im Kapitel ChatGPT-Einstellungen.

Konfiguration testen

Über den Button „Test Configuration" in der Karte „Grundeinstellungen" prüfen Sie, ob ein hinterlegter Schlüssel gültig ist, ohne dafür extra einen echten Übersetzungsauftrag anzulegen.

Rückmeldung	Bedeutung
„Der Test war erfolgreich. Der API-Schlüssel ist Gültig"	Alles in Ordnung
„Es ist kein API-Schlüssel hinterlegt (DeepL oder ChatGPT)."	Kein Schlüssel eingetragen
„Der Testmodus ist Aktiv, es ist kein Test Notwendig"	Der Testmodus ist noch aktiv — der Test wird deshalb übersprungen

Testmodus

Solange der Schalter „Testmodus verwenden" in den Grundeinstellungen aktiv ist, ruft das Plugin keine API auf. Stattdessen werden Übersetzungen durch zufällige Buchstabenfolgen ersetzt, damit beim Ausprobieren garantiert keine Kosten entstehen.

Der Testmodus ist nach der Installation standardmäßig aktiv. Vergessen Sie nicht, ihn vor dem produktiven Einsatz zu deaktivieren — siehe Grundeinstellungen.

Nächster Schritt

Damit angelegte Übersetzungsaufträge auch tatsächlich verarbeitet werden, muss die Message Queue laufen.