Eigenen API-Schlüssel verwenden
Richte Self-Managed in NameQuick 3 auf Mac und Windows ein: mit OpenAI, Anthropic, Gemini, OpenRouter oder einem eigenen OpenAI-kompatiblen Server.
Mit Self-Managed bringst du deinen eigenen API-Schlüssel mit (BYOK, „Bring Your Own Key“): NameQuick nutzt dein eigenes Konto bei einem KI-Anbieter. Du wählst Anbieter und Modell und bezahlst die API-Nutzung direkt beim Anbieter. Diese Anleitung gilt für NameQuick 3 auf Mac und Windows.
API-Schlüssel beim Anbieter erstellen#
| Anbieter | Wo du den Schlüssel erstellst | Beachte |
|---|---|---|
| OpenAI | API-Schlüsselseite | Ein ChatGPT-Abo, auch ChatGPT Plus, enthält kein API-Guthaben; die API wird separat abgerechnet. |
| Anthropic | Claude Console, laut offizieller Anleitung | Beschränke den Schlüssel möglichst auf den vorgesehenen Workspace und beachte die Richtlinien deiner Organisation. |
| Gemini | Google AI Studio | Kontingente und Datennutzungsbedingungen hängen von der Abrechnungsstufe deines Projekts ab. Kostenlose Stufen können andere Datennutzungsbedingungen haben; prüfe sie, bevor du vertrauliche Dokumente verarbeitest. |
| OpenRouter | OpenRouter-Konto, siehe offizielle Kurzanleitung | Guthaben verwaltest du in deinem OpenRouter-Konto. Ein OpenRouter-Schlüssel ist kein direkter Schlüssel von OpenAI, Anthropic oder Google. |
| Custom | Dokumentation des Serverbetreibers | Eigener Server mit OpenAI-Chat-API, siehe den Abschnitt unten. |
Anbieter verbinden und Modell wählen#
Öffne EinstellungenKI. Beispiel mit OpenAI; die Einrichtung folgt bei allen vier Cloud-Anbietern demselben Ablauf.
Anbieter wählen
Wähle unter Anbieter OpenAI. Ist OpenAI noch nicht verbunden, öffnet sich OpenAI verbinden.
Schlüssel einfügen
Füge den Schlüssel in folgendes Feld ein: Füge deinen OpenAI-API-Schlüssel ein. Zusätzliche Leerzeichen entfernt NameQuick automatisch.
Prüfen lassen
Die Prüfung kann automatisch starten. Andernfalls klickst du auf Verbinden. Währenddessen erscheint Schlüssel wird geprüft… oder API-Schlüssel wird geprüft…. Nur erfolgreich geprüfte Schlüssel werden gespeichert.
Modell wählen
Dabei gilt: Mit dem Verbinden wird OpenAI zum aktiven Anbieter. Wähle anschließend unter Modell separat das gewünschte Modell; eine Empfehlung ist bereits vorausgewählt. Manche Anbieter bieten zusätzlich Denk-Aufwand mit niedriger, mittlerer oder hoher Stufe. Änderungen an Anbieter und Modell werden automatisch übernommen.
Nach erfolgreicher Prüfung erscheint Verbunden · Schlüssel in dem macOS-Schlüsselbund gesichert.
Nach erfolgreicher Prüfung erscheint Verbunden · Schlüssel in der Windows-Anmeldeinformationsverwaltung gesichert.
Gut zu wissen
Die Schlüsselprüfung sendet eine kleine echte API-Anfrage und prüft dabei auch, ob die Abrechnung funktioniert. Das kann minimale Anbieterkosten verursachen.
Eigenen OpenAI-kompatiblen Server verwenden#
Für einen eigenen Server wählst du unter Anbieter die Option Custom. Der Server muss die OpenAI-Chat-API unterstützen. Trage seine Basis-URL und unter Modellname die genaue Modellkennung ein. Einen API-Schlüssel gibst du nur an, wenn der Server ihn benötigt. Übernimm Adresse und Modellkennung aus der Dokumentation des Serverbetreibers.
Achtung
Verwende für entfernte Server HTTPS. Bei einer Adresse ohne https warnt NameQuick: Schlüssel und Dateiinhalte gehen unverschlüsselt an diese Adresse.
Schlüssel verwalten#
Deine Schlüssel liegen im macOS-Schlüsselbund (Keychain) beziehungsweise in der Windows-Anmeldeinformationsverwaltung (Windows Credential Manager), nicht als Klartext in einer Einstellungsdatei. Sie bleiben auch gespeichert, wenn du dich von deinem NameQuick-Konto abmeldest.
Unter EinstellungenKI tauschst du einen Schlüssel mit Ersetzen aus. Zum Löschen aus NameQuick wählst du Entfernen und bestätigst mit Schlüssel entfernen. Dadurch wird der Schlüssel beim Anbieter nicht widerrufen. Vermutest du, dass er offengelegt wurde, widerrufe ihn zusätzlich im Dashboard des Anbieters.
Kosten und Datenschutz#
Die NameQuick-Lizenz und deine API-Nutzung sind getrennt. Die Anbieterkosten hängen von Anbieter, Modell, Dateiinhalten und deinem Konto ab. Prüfe Verbrauch und Abrechnung beim Anbieter. Teste zunächst mit einigen Dateikopien, bevor du viele Dateien auf einmal verarbeitest. Beispieltests über Dieses Preset testen sind bei NameQuick kostenlos, nutzen aber weiterhin deinen Anbieter und können dort Kosten verursachen. Mehr dazu unter Lizenz und Credits.
Bei Self-Managed mit Cloud-API gehen die für die Benennung benötigten Inhalte an den gewählten Anbieter, nicht an NameQuick. Das kann die Datei selbst einschließen, etwa Bilder oder PDFs, nicht nur Textauszüge. OpenRouter und Custom-Server haben eigene Regeln zur Weiterleitung und Datennutzung. Prüfe sie vorab. Fällt dein Anbieter aus, wechselt NameQuick nicht stillschweigend zu Managed. Weitere Informationen findest du unter Datenschutz.
Häufige Probleme#
Die folgenden Meldungen mit Anbieternamen zeigen OpenAI als Beispiel.
„Ungültiger API-Schlüssel. Bitte prüfen und noch einmal versuchen.“
Prüfe, ob du den richtigen Schlüssel vollständig kopiert und den passenden Anbieter gewählt hast.
Bei OpenAI hat diesen Schlüssel beim letzten Lauf abgelehnt. Ersetze ihn, um weiterzumachen. tauschst du den Schlüssel über Ersetzen aus, auch wenn er zuvor funktioniert hat.
„Dein OpenAI-Konto hat kein API-Guthaben.“
Die vollständige Meldung lautet: Dein OpenAI-Konto hat kein API-Guthaben. Hinterlege bei OpenAI eine Zahlungsart und versuch es noch einmal. Kläre die Abrechnung beim Anbieter oder lade Guthaben auf. Wiederhole danach die Verbindung. Bei dieser fehlgeschlagenen Prüfung wird der Schlüssel nicht gespeichert.
„Zeitüberschreitung“ oder „Keine Internetverbindung“
Zeitüberschreitung — prüf deine Internetverbindung und Keine Internetverbindung weisen auf Netzwerkprobleme hin, nicht auf einen nachweislich falschen Schlüssel. Prüfe deine Verbindung und versuche es erneut.
Bei Prüfung gerade nicht möglich. Bitte noch einmal versuchen. wiederholst du die Prüfung später.
Modell-Liste nicht verfügbar
Die Modell-Liste von OpenAI ließ sich nicht laden. Zu sehen sind dein aktuelles Modell und die Empfehlungen. Dein aktuelles Modell und die empfohlenen Modelle bleiben auswählbar.
Schlüsselspeicher nicht lesbar
Prüfe, ob NameQuick auf den macOS-Schlüsselbund beziehungsweise die Windows-Anmeldeinformationsverwaltung zugreifen kann. Ersetze den Schlüssel nicht vorschnell: Ein Zugriffsproblem beweist nicht, dass er ungültig ist. Weitere Hilfe findest du unter Problemlösung.