Eigenen API-Key verwenden

Mit der Selbst-verwaltet-Lizenz (Bring Your Own Key, BYOK) nutzt NameQuick Ihr eigenes KI-Anbieter-Konto statt verwalteter Credits. Sie zahlen direkt beim Anbieter nach Verbrauch — typischerweise einen Bruchteil eines Cents pro Umbenennung — und für NameQuick nur einmal. Ihr Key wird sicher im macOS-Schlüsselbund gespeichert und verlässt Ihren Mac nur für die Kommunikation mit dem von Ihnen gewählten Anbieter.

Sie möchten API-Keys ganz vermeiden? Nutzen Sie stattdessen ein lokales Modell auf Ihrem Mac — kein Konto, kein Key, nichts verlässt Ihren Rechner.

---

Key in NameQuick hinzufügen#

Die Schritte sind für jeden Cloud-Anbieter gleich:

1. Öffnen Sie NameQuick → Einstellungen → AI.
2. Wählen Sie den gewünschten Anbieter.
3. Fügen Sie Ihren API-Key in das Key-Feld ein. NameQuick speichert ihn im macOS-Schlüsselbund.
4. Wählen Sie ein Modell (jeder Anbieter zeigt einen sinnvollen Standard) und benennen Sie eine Testdatei um, um zu prüfen, dass alles funktioniert.

Sobald ein Anbieter verbunden ist, bleibt das gesamte Umbenennen bei diesem Anbieter — NameQuick wechselt nie stillschweigend zu einem anderen.

---

Wo Sie die Keys bekommen#

OpenAI#

1. Melden Sie sich an unter platform.openai.com/api-keys.
2. Klicken Sie auf Create new secret key, geben Sie ihm einen Namen wie "NameQuick" und kopieren Sie ihn — OpenAI zeigt den Key nur einmal an.
3. Laden Sie unter Billing ein kleines Guthaben auf, falls Ihr Konto keines hat. Ein paar Dollar reichen für Tausende Umbenennungen.

Hinweis: Ein OpenAI-API-Konto ist getrennt von ChatGPT Plus. Ein ChatGPT-Abo enthält kein API-Guthaben.

Anthropic (Claude)#

1. Melden Sie sich an unter console.anthropic.com/settings/keys.
2. Klicken Sie auf Create Key, kopieren Sie ihn und laden Sie bei Bedarf unter Plans & Billing Guthaben auf.

Google Gemini#

1. Melden Sie sich mit einem Google-Konto an unter aistudio.google.com.
2. Klicken Sie auf Create API key und kopieren Sie ihn. Gemini hat ein großzügiges kostenloses Kontingent — ein guter erster Anbieter zum Ausprobieren.

OpenRouter#

1. Melden Sie sich an unter openrouter.ai/keys.
2. Klicken Sie auf Create Key, kopieren Sie ihn und laden Sie Ihr OpenRouter-Guthaben auf.

OpenRouter ist ein Key für viele Modelle — praktisch, wenn Sie verschiedene Modelle ausprobieren möchten, ohne bei jedem Anbieter ein Konto anzulegen.

---

Was Umbenennen mit eigenem Key kostet#

Eine Umbenennung sendet eine kleine Menge extrahierten Text (oder Bilddaten bei Fotos und Scans) an den Anbieter und erhält einen kurzen Dateinamen zurück. Die genauen Preise ändern sich, aber mit aktuellen gängigen Modellen kostet eine typische Dokument-Umbenennung deutlich unter einem Cent, und selbst bildlastige Stapel bleiben günstig. Prüfen Sie nach dem ersten Stapel das Dashboard Ihres Anbieters — die Zahlen sind meist beruhigend klein.

---

Hinweise zum Datenschutz#

• Keys werden im macOS-Schlüsselbund gespeichert, nicht in NameQuicks Einstellungsdateien.
• Nur extrahierter Text (oder das Bild, für visuelle Analyse) wird an den gewählten Anbieter gesendet. Die Dateien selbst werden nie auf NameQuick-Server hochgeladen.
• Für Verarbeitung ganz ohne Cloud siehe lokale Modelle.
• Die vollständige Aufschlüsselung pro Modus, was Ihren Mac verlässt: Datenschutz & Ihre Daten.

---

Häufige Probleme#

"Add your API key in Settings → AI" — der gewählte Anbieter hat noch keinen Key, oder der Key wurde entfernt. Fügen Sie einen gültigen Key ein und versuchen Sie es erneut.

Umbenennungen schlagen direkt nach dem Hinzufügen eines Keys fehl — meistens hat das Anbieter-Konto kein Guthaben. Prüfen Sie die Billing-Seite des Anbieters; Keys funktionieren nur, wenn das Konto belastet werden kann.

Rate-Limit-Fehler bei großen Stapeln — neue Anbieter-Konten haben oft niedrige Limits, die nach einigen Tagen Nutzung automatisch steigen. Verarbeiten Sie einen kleineren Stapel, oder warten Sie und versuchen Sie es erneut.

Für alles Weitere siehe Fehlerbehebung.