So verwenden Sie Ihren OpenAI-API-Schlüssel in einer Windows-Desktop-App

Was Sie brauchen

Windows 10 (ab Build 19041) oder Windows 11, x64

Darauf läuft SideNote Pro. Die 30-Tage-Testversion ist die vollständige Anwendung, Sie können all das also tun, bevor Sie eine Lizenz kaufen.

Ein OpenAI-Konto auf der Entwicklerplattform

Dort werden API-Schlüssel ausgestellt. Wenn Sie sich bereits bei OpenAI anmelden, ist es dasselbe Konto.

API-Guthaben darauf

OpenAI berechnet die API-Nutzung getrennt von allem anderen, was Sie dort bezahlen. Ein Konto mit Vorauszahlung läuft über vorausbezahltes Guthaben statt über eine Rechnung; Konten mit Rechnungsstellung funktionieren anders, und dieser Leitfaden beschreibt die Vorauszahlung.

Sonst nichts

Kein SDK, kein Python, kein Terminal und kein Schlüssel in einer Umgebungsvariablen. Der Schlüssel kommt in ein einziges Feld, im Quick Setup oder in Settings.

Zehn Minuten sind eine realistische Schätzung für das Ganze, und das meiste davon fällt auf der Seite von OpenAI an, nicht in SideNote Pro.

Ein ChatGPT-Abonnement ist kein API-Zugang

ChatGPT und die OpenAI-API sind zwei Produkte hinter einem Konto, und sie werden getrennt abgerechnet. Ein ChatGPT-Abonnement enthält kein API-Guthaben.

Ein ChatGPT-Plus-Abonnement enthält also kein API-Guthaben, und API-Guthaben bezahlt kein ChatGPT. Was SideNote Pro braucht, ist die rechte Spalte: einen Schlüssel und Guthaben dahinter.

Einen API-Schlüssel erstellen

1. Bei der OpenAI-Entwicklerplattform anmeldenBei der Entwicklerplattform, nicht auf chatgpt.com. Wenn Sie schon ein Konto haben, ist es dieselbe Anmeldung.
2. Eine Zahlungsmethode und etwas Guthaben hinzufügen und ein Ausgabenlimit festlegenLegen Sie das Limit jetzt fest, nicht später. Eine feste Obergrenze im Dashboard des Anbieters ist das einzige maßgebliche Limit, weil es das einzige ist, das jede Anwendung sieht, die diesen Schlüssel verwendet.
3. Einen geheimen Schlüssel erstellenUnter platform.openai.com/api-keys. Kopieren Sie ihn sofort und benennen Sie ihn danach, wo er verwendet wird: Ein geheimer Schlüssel wird in der Regel nur einmal angezeigt und nie wieder.

Settings › Setup guide

Den Schlüssel mit SideNote Pro verbinden

Bei einer neuen Installation: Quick Setup

Starten Sie die Testversion, dann zeigt SideNote Pro den Bildschirm Set up SideNote Pro. Er beginnt mit Connect with OpenRouter, was die Anmeldung über Ihren Browser erledigt und keinen Schlüssel von Ihnen verlangt. Für OpenAI öffnen Sie auf demselben Bildschirm Use an OpenAI API key instead: Verlangt wird genau eines, Ihr OpenAI-API-Schlüssel. Es gibt nichts zu wählen bei Anbietern, Endpunkten oder Modellen.

1. Den Schlüssel einfügenHaben Sie noch keinen erstellt, öffnet Create API key in diesem Bereich die Schlüsselseite von OpenAI, und Open OpenAI billing steht direkt darunter für ein Konto, das die API noch nie genutzt hat.
2. Connect & continue wählenSideNote Pro fragt OpenAI mit Ihrem Schlüssel nach der Modellliste, derselben Anfrage, die Test & Load models sendet. Gespeichert wird nichts, solange das nicht gelingt.
3. Start using SideNote wählenDas Profil wird angelegt, der Schlüssel wird für Ihr Windows-Konto verschlüsselt gespeichert, und die Modellauswahl steht mit den chatfähigen Modellen aus der Liste von OpenAI bereit.

Das Ergebnis ist das Profil in der Tabelle unten, mit gpt-6-luna und Reasoning effort auf None, und es ist ein gewöhnliches: Nichts bindet es an Quick Setup, und jedes Feld bleibt bearbeitbar. Lehnt OpenAI den Schlüssel ab oder ist nicht erreichbar, sagt der Bildschirm das in einer kurzen Erklärung und speichert nichts. Kann der Schlüssel gpt-6-luna nicht nutzen, bietet er die manuelle Einrichtung an, statt Sie stillschweigend auf ein anderes Modell umzustellen.

Quick Setup aus Settings, jederzeit

Quick Setup oben in Settings › AI providers öffnet dieselbe geführte Einrichtung, wann immer Sie möchten, mit dem OpenAI-Weg unter Use an OpenAI API key instead: nachdem Sie sie übersprungen haben, die manuelle Einrichtung gewählt oder zuerst einen anderen Anbieter eingerichtet haben. Ist schon ein Anbieter konfiguriert, fügt sie ein neues Profil hinzu und lässt jedes vorhandene Profil, jeden Endpunkt, jedes Modell, jeden Schlüssel und Ihren Standardanbieter, wie sie waren. Das neue Profil wird nur dann Ihr Standard, wenn Sie Use this provider by default anhaken.

Solange kein Schlüssel hinterlegt ist, sagt ein Hinweis Finish AI setup über dem Nachrichtenfeld in jeder Unterhaltung, dass Ihr Anbieter noch einen braucht, mit AI providers und, sofern Sie nicht selbst einrichten wollten, Quick Setup. Senden ohne Schlüssel sendet nichts und lässt Ihre Nachricht und Anhänge, wo sie sind.

Von Hand oder für ein weiteres Profil

Quick Setup erscheint von selbst nur bei einer neuen Installation. Richten Sie das Profil von Hand ein, wenn Sie I'll set it up manually gewählt haben, Modell und Einstellungen selbst bestimmen möchten oder ein zweites OpenAI-Profil mit einem anderen Modell wollen.

1. Settings öffnen, dann AI providersFügen Sie ein Profil hinzu und wählen Sie in der Liste Provider oben im Editor OpenAI.
2. Ihren OpenAI-API-Schlüssel einfügenDer Endpunkt ist schon eingetragen, der Schlüssel ist also der einzige Wert, den Sie liefern müssen.
3. Test & Load models wählenEs bestätigt, dass der Schlüssel OpenAI erreicht, ermittelt die Modelle, die Ihr Konto nutzen kann, und zeigt in der Auswahl Model standardmäßig die chatfähigen an.
4. Ein Modell wählen oder seine ID eintippenÖffnen Sie die Liste, tippen Sie zum Filtern oder geben Sie selbst eine ID ein. Beide Wege führen zum selben Profil.
5. Das Profil speichernCtrl+S (Ctrl ist die Taste Strg) oder die Aktion in der Fußleiste. Lassen Sie Context window auf Auto, wenn Sie keinen Grund dagegen haben.

Settings › AI providers

Die Base URL steht hier als Referenzwert, nicht als etwas zum Eintippen. Sie ist auch nicht festgelegt: Laufen Ihre Anfragen über ein Firmen-Gateway oder einen Proxy, ändern Sie sie, und der Rest des Profils funktioniert unverändert. Jeden OpenAI-kompatiblen Anbieter konfigurieren behandelt diesen Fall ausführlich.

gpt-6-luna ist das Modell, mit dem ein neues OpenAI-Profil beginnt, und es ist ein vernünftiger Alltagsstandard, keine Obergrenze. Test & Load models ermittelt weiterhin die ganze Liste des Anbieters, aber die Auswahl zeigt jetzt standardmäßig Konversationsmodelle, damit Sprach-, Transkriptions-, Embedding-, Moderations-, Echtzeit- und Videomodelle die Liste nicht überfüllen. Show all models in Settings zeigt den Rest. Das passende KI-Modell wählen behandelt, wie Sie zwischen den Konversationsmodellen wählen.

Der Schlüssel sk-example-not-a-real-key ist ein Platzhalter. Echte Schlüssel stellt nur Ihr Anbieter aus.

Reasoning effort, nur so weit, wie die Einrichtung es braucht

Ein Feld in diesem Profil ist jetzt dreißig Sekunden wert, denn die beiden Einstellungen, die Menschen verwechseln, sind die beiden oben in der Liste. None ist das, womit ein neues OpenAI-Profil beginnt, und es ist eine Anweisung: Es bittet das Modell um gar kein Reasoning, was nur bei einem Modell etwas bedeutet, das den Wert dokumentiert. Provider default ist die vorsichtige Antwort und der Beginn von Profilen für andere Anbieter: SideNote Pro lässt das Feld reasoning_effort in der Anfrage ganz weg, und das Modell tut, was es ohne Aufforderung tut.

gpt-6-luna dokumentiert ihn, weshalb ein neues Profil mit None beginnt: Das ist die schnelle Alltagskonfiguration aus der günstigen GPT-6-Luna-Einrichtung. Wechseln Sie zu einem Modell, das none nicht dokumentiert, setzen Sie das Feld auf Provider default. Reasoning effort erklärt behandelt, was jede Einstellung sendet und wann sich eine Erhöhung die Wartezeit lohnt.

Test & Load models und was es Ihnen sagt

Die Schaltfläche erledigt zwei Aufgaben zugleich. Sie ruft GET https://api.openai.com/v1/models mit Ihrem Schlüssel als Bearer-Token auf, was den Endpunkt und den Schlüssel belegt, und ermittelt die Modell-IDs, die zurückkommen. Bei den integrierten Voreinstellungen für OpenAI, Anthropic, Gemini und DeepSeek zeigt die durchsuchbare Auswahl Model standardmäßig chatfähige Modelle; Show all models zeigt auch die Einträge ohne Chat. Ein bestandener Test meldet weiterhin die vollständige Anzahl der Modelle, die der Anbieter nennt.

Das ist eine Erleichterung, keine Schranke. Kennen Sie die gewünschte Modell-ID schon, tippen Sie sie in Model und senden eine Nachricht: Nichts muss erst ermittelt werden, bevor es genutzt werden kann.

Ein bestandener Test belegt nur, dass der Schlüssel OpenAI erreicht. Er belegt nicht, dass das Konto API-Guthaben hat oder ein bestimmtes Modell für Anfragen nutzen kann. Senden Sie etwas Echtes, bevor Sie der Einrichtung trauen: Drücken Sie Ctrl+Shift+Space von überall, tippen Sie eine Frage und sehen Sie zu, wie die Antwort eintrifft. Trifft kein Symptom oben auf Sie zu, behandelt die Fehlerbehebung den Rest, auch Tastenkombinationen, die nicht auslösen, und Anhänge, die abgelehnt werden.

Das Erste, was sich damit lohnt

Die Einrichtung ist fertig; dafür war sie da. Im Eingabebereich zu tippen funktioniert, ist aber die uninteressanteste Art, einen Schlüssel auf dem Desktop zu nutzen, denn es verlangt weiterhin, dass Sie den Text zum Assistenten bringen. Aktionen für markierten Text kehren das um.

1. In einer Windows-Anwendung Text markierenEin Absatz in Word, eine Zeile in Notepad, ein Satz in einem Textfeld in Chrome. Erfasst wird nichts, bis Sie eine Tastenkombination für eine Aktion drücken.
2. Ctrl+Shift+E drückenExplain, eine von fünf Aktionen, mit denen eine neue Installation ausgeliefert wird. Die Markierung geht mit einer festen Anweisung an das OpenAI-Profil, das Sie gerade konfiguriert haben.
3. Die Antwort neben dem Fenster lesen, in dem Sie warenSie läuft in den Assistenten am Bildschirmrand ein. Esc fährt ihn ein, und die Anwendung, in der Sie gearbeitet haben, hat den Fokus nie länger verloren als die Dauer der Anfrage.

Die anderen vier sind Ask SideNote auf Ctrl+Shift+A, das die Markierung erfasst und auf Ihre Frage wartet, statt sofort zu senden, dann Summarize, Rewrite und Translate. Eigene Aktionen machen aus einer Anweisung, die Sie immer wieder tippen, einen Tastendruck: KI-Aktionen für markierten Text behandelt, wie Sie sie erstellen.

Was SideNote Pro tatsächlich sendet

Sie bauen nie selbst eine HTTP-Anfrage. Aber die Form zu kennen hilft enorm, wenn Sie später einen kompatiblen Anbieter debuggen, und sie sagt Ihnen, welche Dokumentation gilt.

GET https://api.openai.com/v1/models
Authorization: Bearer sk-example-not-a-real-key

POST https://api.openai.com/v1/chat/completions
Authorization: Bearer sk-example-not-a-real-key
Content-Type: application/json

{
  "model": "gpt-6-luna",
  "stream": true,
  "messages": [ ... ]
}

Die Antwort kommt als Server-Sent Events zurück, data:-Einträge, abgeschlossen mit [DONE], wodurch Text erscheint, während er erzeugt wird, statt in einem Block einzutreffen.

Bei gewöhnlichen Anfragen sendet SideNote Pro Text und Bilder und streamt Text zurück. Web search ist eine optionale Einstellung je Unterhaltung für unterstützte Anbieter; Audio, Video und Bilderzeugung gehören nicht zu diesem Anfrageweg.

Verstehen, was Ihnen berechnet wird

Die API-Abrechnung erfolgt pro Token, für Eingabe und Ausgabe getrennt bepreist, und sie unterscheidet sich je nach Modell. Preise der Anbieter ändern sich, und eine veraltete Zahl ist schlimmer als keine, prüfen Sie also die Preisseite Ihres Anbieters selbst.

Was Sie in SideNote Pro tun können, ist, diese Preise pro Profil und Modell in USD pro Million Token zu hinterlegen, was das lokale Protokoll in aussagekräftige Schätzungen verwandelt. Siehe Nutzungs- und Kostenerfassung und KI-API-Kosten senken für die Gewohnheiten, auf die es am meisten ankommt.

Die einmalige Lizenz für SideNote Pro gilt für die Windows-Anwendung. Ein gehosteter Anbieter kann die API-Nutzung gesondert berechnen; ein lokales Modell verursacht keine API-Kosten. Siehe was eine Lizenz abdeckt und was BYOK bedeutet.

Settings › AI providers › Model pricing

Dieselben Schritte für einen anderen Anbieter

Quick Setup deckt OpenRouter und OpenAI ab. Jeder andere Anbieter nimmt den manuellen Weg von oben: Wählen Sie in der Liste Provider einen anderen Eintrag, der Endpunkt ändert sich mit, und die Schritte sind dieselben, nur dass das Modell leer beginnt und Reasoning effort mit Provider default beginnt. Anthropic, Google Gemini und DeepSeek sind gehostet und wollen jeweils einen Schlüssel aus der eigenen Konsole; alle drei veröffentlichen eine Modellliste, Test & Load models füllt die Auswahl also auch bei diesen Profilen, mit standardmäßig ausgeblendeten Modellen ohne Chat. Auch OpenRouter ist gehostet und hat eine eigene Anleitung, einschließlich der Anmeldung im Browser. Unterstützte KI-Anbieter listet auf, womit jede Wahl beginnt.

Ollama und LM Studio laufen auf Ihrem eigenen Rechner und brauchen meist gar keinen Schlüssel. Alles, was nicht in der Liste steht, ist ein Custom OpenAI-compatible-Profil mit eingetippter Base URL und Modell-ID, was ein vollwertiger Weg ist und kein Notbehelf: siehe jeden OpenAI-kompatiblen Anbieter konfigurieren.