Zum Hauptinhalt springen

OpenAI Anbieter

💡TL;DR

OpenAI verwendet den gemeinsam genutzten, OpenAI-kompatiblen Transport. Die aktuelle Voreinstellung verwendet standardmäßig gpt-4o, https://api.openai.com/v1, temperature: 0.5 sowie den models-then-chat-Verbindungscheck. Verwenden Sie diese Seite, wenn Sie genaue Feldsemantiken benötigen; nutzen Sie die Übersicht der LLM Anbieter für eine Auswahl auf Kategorienebene.

Dies ist ein Teil des Obsidian AI-Know-how-Management-Leitfadens.

Einrichtung

Erstellen Sie einen OpenAI API-Schlüssel, fügen Sie ein OpenAI-Anbieterprofil in den Notemd-Einstellungen hinzu und behalten Sie den Standard-Base URL bei, es sei denn, Sie verweisen absichtlich auf eine OpenAI-kompatible Gateway. Das Modellfeld kann für allgemeine Arbeiten bei gpt-4o bleiben oder durch eine andere OpenAI-Modell-ID ersetzt werden, die Ihr Konto aufrufen kann.

Verwenden Sie modellbezogene Modelle zur Kostenkontrolle: Behalten Sie leistungsstärkere Modelle für Forschung, Konzeptextraktion und umfassende Umstrukturierung bei; verwenden Sie günstigere oder schnellere Modelle für Übersetzungen, Linkvorschläge und kurze Zusammenfassungen.

Endpunkt und Authentifizierung

FeldAktuelle Voreinstellung
Transportopenai-compatible
API SchlüsselErforderlich
Base URLhttps://api.openai.com/v1
Standardmodellgpt-4o
Temperatur0.5
Verbindungsprüfung/models, dann /chat/completions

Notemd normalisiert die OpenAI-kompatible Basis URLs, bevor chat/completions oder models hinzugefügt werden. Fügen Sie kein nachstehendes /chat/completions zur Basis URL hinzu; das erzeugt einen doppelten Pfad.

Modellentdeckung

OpenAI verwendet den generischen, OpenAI-kompatiblen Modell-Auffindungspfad. Die Einstellungen UI fragen zunächst /v1/models ab und überprüfen anschließend das ausgewählte Modell mit einer einfachen Chatanfrage. Falls die Auffindung fehlschlägt, aber der Chat weiterhin funktioniert, prüfen Sie, ob Ihre Zugangsdaten die Berechtigung „Model-Liste“ haben oder ob ein Gateway die Anzeige von Modellen blockiert.

Reasoning-Modelle werden als Sonderfall des Protokolls betrachtet: Notemd fügt den Inhalt von System- und Benutzereingaben zusammen, um OpenAI Reasoning-IDen zu erzeugen, die eine separate system Rolle ablehnen, und es stellt reasoningEffort nur dann zur Verfügung, wenn die Anbieterdefinition dies unterstützt.

Fehlerbehebung

  • 401 oder 403: Überprüfen Sie den Schlüssel, den Projektzugriff, den Abrechnungszustand sowie ob das ausgewählte Modell für den Schlüssel aktiviert ist.
  • 404 im Chat: Die Basis URL ist in der Regel falsch oder enthält bereits /chat/completions.
  • Das Modell erscheint in den Dokumenten, aber nicht im Selektor: Der Zugriff auf model-list und der Zugriff auf Chat sind getrennte Fehlerquellen; prüfen Sie die genaue Modell-ID manuell im Provider-Profil.
  • Das Reasoning-Modell lehnt Nachrichten ab: Verwenden Sie eine Modell-ID, die vom OpenAI Reasoning-Handling-Pfad abgedeckt wird, oder wechseln Sie zu einem nicht-Reasoning-Chat-Modell.

Wann verwenden

Verwenden Sie OpenAI, wenn Sie den vorhersehbarsten Standard-Hosted-Pfad wünschen, wenn die Entdeckung von /v1/models wichtig ist oder wenn ein Workflow von den Semantiken des OpenAI-Reasoning-Modells abhängt. Wählen Sie einen Gateway oder einen lokalen Anbieter, wenn Routing, Datenschutz oder Kosteneinschränkungen wichtiger sind als das direkte OpenAI API-Verhalten.


Nächste Schritte

  • LLM Anbieter -- Vollständige Konfiguration, modellbasierte Verarbeitung pro Aufgabe und Wiederholungslogik
  • Fehlerbehebung -- Behebung von Fehlern 401/403 sowie Rate-Limit-Fehlern