OpenAI und OpenAI Image

OAR bietet zwei Provider, die mit deinem eigenen OpenAI-API-Key laufen, und du speicherst den Key einmal für beide.

• OpenAI (BYOK) ist ein Coding-Agent. Es ist die GitHub-Copilot-Runtime, die mit deinem Key auf die OpenAI API (oder einen kompatiblen Endpunkt) zeigt statt auf die Modelle eines Copilot-Plans. Er liest Dateien, führt Befehle aus und bearbeitet Code wie eine Copilot-Konversation.
• OpenAI Image (BYOK) ist kein Agent. Es ist ein Chat, in dem jede Nachricht zu einer Anfrage an die OpenAI Images API wird und jede Antwort ein oder mehrere Bilder ist.

Beide rechnen über dein OpenAI-Konto ab. Der OpenAI-Agent braucht die GitHub Copilot CLI auf dem Relay-Host, weil die Copilot-Runtime ihn ausführt; siehe GitHub Copilot. Der Bild-Provider nutzt die Copilot CLI nicht.

Einrichten #

Öffne Settings → Providers → OpenAI (Einstellungen → Provider → OpenAI).

Drück Save OpenAI settings (OpenAI-Einstellungen speichern). Das Relay fragt dann den Endpunkt nach seiner Modellliste (/models unter der Basis-URL) und fügt hinzu, was es findet, zu den Modellauswahlen. Schlägt das fehl, sind die Einstellungen trotzdem gespeichert und ein Hinweis sagt, warum; die bisherigen Modelle bleiben.

Der Key wird in der Datenbank des Relays auf dem Host gespeichert. Das Feld zeigt ihn nie wieder: Sobald ein Key gespeichert ist, steht im Platzhalter Saved API key (enter to replace). Lass es leer, um den gespeicherten Key zu behalten, oder tipp einen neuen ein, um ihn zu ersetzen.

Die Statuszeile unter den Feldern sagt dir, wo du stehst:

OpenAI API is enabled. Select OpenAI in New Chat to use model gpt-4o.
API key saved but currently disabled. Enable it to allow OpenAI selection in New Chat.
Not configured. New conversations use GitHub Copilot.

Ausschalten oder den Key entfernen #

Bild-Chats zählen hier als OpenAI-Konversationen. In der Praxis lässt sich der Key erst entfernen, wenn jede OpenAI- oder OpenAI-Image-Konversation mit einer Nachricht gelöscht ist. Wenn du nur neue OpenAI-Chats verhindern willst, schalte stattdessen den Schalter aus. Konversationen anderer Provider spielen keine Rolle.

Ein anderer Endpunkt #

Trag die Adresse eines beliebigen Endpunkts, der die OpenAI API spricht, in Base URL ein, zum Beispiel https://llm.example.com/v1, und den Key, den dieser Endpunkt erwartet, in OpenAI API key. Der Agent spricht mit ihm für Konversationen, das Relay für die Modellerkennung und für Bilder. Speicherst du wieder die Standardadresse, wird der gespeicherte Wert gelöscht.

Der Agent braucht ein Modell, das Tool-Aufrufe und Streaming unterstützt, mit einem Kontextfenster von mindestens 128k Tokens für die besten Ergebnisse. Das ist die Anforderung der Copilot CLI an jedes Bring-your-own-Key-Modell; OAR prüft es nicht. Ein Bild-Chat braucht einen Endpunkt mit der Route zur Bilderzeugung und, für Bearbeitungen, der Route zur Bildbearbeitung, und der ein Bildmodell auflistet.

OpenAI, der Agent #

Wähl OpenAI (BYOK) als Provider in New Chat. Die Modellliste ist die für deinen Key gespeicherte. Die Konversation verhält sich dann wie eine Copilot-Konversation: dieselbe Modusauswahl, Queue, Nachsteuern, Rückfrage-Karten und Datei-Tools. Siehe Eine Konversation starten für den Dialog und Relay-Modi für die Modi.

Was daraus folgt, dass er auf der Copilot-Runtime läuft:

• Die Copilot-Engine bestimmt die Funktionen. Sie ist die relayweite Wahl unter Settings → Providers → Copilot → Copilot engine (Einstellungen → Provider → Copilot → Copilot-Engine), gelesen, wenn der Worker einer Konversation startet. Nachsteuern, die Task-Leiste für Hintergrund-Tasks und Rückfrage-Karten hängen davon ab; siehe GitHub Copilot.

• Das Modell ist festgelegt. Nach der ersten Nachricht ist der Eingabebereich auf das Modell festgelegt, mit dem die Konversation begann, und die Notiz über der Eingabe nennt es.

• Der Reasoning-Effort hängt vom Modell ab. Die Optionen für Reasoning effort (Reasoning-Effort) folgen dem Namen des Modells. Die erste Option ist vorausgewählt, außer du hast zuletzt eine andere genutzt.

  Modellname beginnt mit	Optionen
  gpt-5, codex	none, low, medium, high, xhigh
  o1, o3, o4	low, medium, high
  alles andere	none

• Wire-Format. Modelle gpt-5, codex-, o1, o1-, o3, o3- und o4- nutzen die Responses API; andere nutzen Chat Completions. Das ist wichtig, wenn dein Endpunkt nur eines von beiden unterstützt.

• Kein Plan-Verbrauch. OpenAI-Turns haben keine Verbrauchszeile unter der Antwort und keinen Eintrag in Check Usage (Verbrauch prüfen); diese gibt es nur für Copilot. Kompaktierung, Neustarts und Fortsetzen funktionieren wie bei Copilot: siehe Kompaktieren und Neustarts und Fortsetzen.

OpenAI Image, der Bild-Chat #

Ein Bild-Chat dient dazu, Bilder aus einer Beschreibung zu erstellen und zu überarbeiten. Es gibt keinen Agent: Das Relay sendet deine Nachricht an die Images API und zeigt im Chat, was zurückkommt.

Einen starten #

1. Öffne New Chat und setz Provider auf OpenAI Image (BYOK). Er erscheint neben OpenAI (BYOK), sobald OpenAI aktiviert ist.
2. Wähl ein Model (Modell). Nur Bildmodelle werden aufgelistet: solche, deren Name mit gpt-image- oder dall-e- beginnt. Die Modellerkennung des Relays behält nur Namen, die mit gpt-, chatgpt-, o1, o3, o4-, codex- oder openai/ beginnen, daher werden gpt-image-*-Modelle von deinem Endpunkt gefunden, ein dall-e-*-Modell erscheint aber nur, wenn du seine ID als OpenAI model ID einträgst. Ist kein Bildmodell aufgelistet, gibt es nichts zu wählen.
3. Setz Quality (Qualität) und Size (Größe).
4. Drück Start chat (Chat starten) und beschreib dann das Bild.

Ein Chat mit einem Modell, das kein Bildmodell ist, wird abgelehnt: OpenAI image provider requires an image model (received "model-name").

„Zuletzt genutzt“ wird pro Browser gespeichert. Im offenen Chat behält der Eingabebereich beide als Auswahlen: die Qualität an der Stelle des Reasoning-Efforts, mit dem Titel Quality, und die Größe mit dem Titel Image size (Bildgröße). So kannst du sie von Nachricht zu Nachricht ändern. Jede Nachricht erzeugt ein Bild. Qualität und Größe werden auch in Eine Konversation starten gesetzt.

Bearbeiten und Folgenachrichten #

Eine neue Nachricht ergibt ein neues Bild. Um ein vorhandenes zu überarbeiten, nutz Edit this image (Dieses Bild bearbeiten) darunter:

1. Drück Edit this image unter dem Bild. Ein Chip über dem Eingabebereich zeigt Editing (Bearbeiten) und den Namen des Bildes, mit einem Button zum Abbrechen, und die Eingabe fragt Describe how to edit this image….
2. Tipp ein, was sich ändern soll, und sende. Das Relay sendet genau dieses Bild und deinen Text an die Bearbeitungsroute der Images API, und das neue Bild erscheint als Antwort.
3. Das neue Bild hat ebenfalls Edit this image und einen Link Edited from previous image (Aus dem vorigen Bild bearbeitet), der zu dem Bild zurückspringt, aus dem es entstand.

Weil die Bearbeitung von dem Bild ausgeht, unter dem du den Button gedrückt hast, kannst du verzweigen: ein älteres Bild erneut bearbeiten, ohne dass die späteren mitkommen. Der Chip verschwindet, nachdem die Nachricht gesendet ist.

Du kannst in einem Bild-Chat auch ein eigenes Bild anhängen. Das erste angehängte Bild ist das, das bearbeitet wird. Nur das erste wird verwendet.

Wo die Bilder liegen #

Das Relay speichert jedes erzeugte Bild als Datei auf dem Host, im Session-State-Ordner der Copilot CLI (~/.copilot/session-state oder der Ordner, den COPILOT_SESSION_STATE_DIR nennt), unter der Konversation. Von dort zeigt es sie im Chat, und ein geteilter Nur-Lese-Link zeigt sie ebenfalls. Sie bleiben, solange die Konversation besteht; das Löschen der Konversation löscht ihre Bilder.

Was ein Bild-Chat nicht hat #

Die Anfrage besteht nur aus deinem Text und, bei einer Bearbeitung, einem Bild. Daher gibt es keinen Arbeitsordner zum Lesen oder Schreiben, keine Tools, keine Rückfragen von einem Agent, kein Nachsteuern eines laufenden Turns, keine Hintergrund-Tasks und keine Kompaktierung. Die Modusauswahl wird noch angezeigt, hat aber keine Wirkung; siehe Relay-Modi. Auf dem Relay-Host läuft außer der Anfrage nichts.

Schlägt eine Anfrage fehl, zeigt der Chat den Grund in der Antwort. Ein Fehler, den der Endpunkt als Client-Fehler meldet (Status 400 bis 499), wird nicht wiederholt; der Turn schlägt fehl mit Error code: relay.image-provider-rejected. Ein Netzwerkfehler oder ein Serverfehler wird wiederholt. Wird das Relay unterbrochen, nachdem ein Bild möglicherweise schon erzeugt wurde, wird es nicht erneut ausgeführt, um Duplikate zu vermeiden.

Kosten #

Beide Provider rechnen über dein OpenAI-Konto ab oder über das Konto, zu dem dein Endpunkt gehört. OAR misst das nicht: OpenAI-Turns haben keine Verbrauchszeile und keinen Eintrag in Check Usage, und Bildanfragen zeigen keine Kosten. Behalte deine Ausgaben im Dashboard deines Providers im Blick. Eine Bildnachricht ergibt eine Bildanfrage; ein Agent-Turn kann viele Modellanfragen stellen, weil jeder Tool-Schritt ein weiterer Roundtrip ist.

Im Vergleich #

Wenn es nicht funktioniert #