Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

OpenAI auf Google Cloud

OpenAI-Modelle sind über Google Cloud derzeit im Rahmen einer privaten Vorschau verfügbar. Wenn du sie in deinem Projekt verwenden möchtest, beantrage den Zugriff.

Über Google Cloud kannst du OpenAI-Modelle auf der Gemini-Plattform nutzen. Die Abrechnung erfolgt über dein Google Cloud-Konto. Die Modelle laufen innerhalb des Sicherheitsperimeters von Google Cloud. Deine Organisation verwaltet den Zugriff über Google Cloud IAM.

Diese Anleitung zeigt dir, wie du über Google Cloud eine Anfrage an die Responses API sendest und welche Funktionen im Vergleich zur direkt von OpenAI angebotenen API verfügbar sind.

Folgende Modelle stehen zur Verfügung:

Modell Modell-ID
GPT-6 Luna gpt-6-luna
GPT-6.1 Sol gpt-6.1-sol
GPT-6.1 Terra gpt-6.1-terra
GPT-6 Astra gpt-6-astra

Voraussetzungen

Bevor du Anfragen senden kannst, muss die für die Google Cloud-Administration zuständige Person folgende Schritte ausführen:

  • Die Abrechnung für das Projekt aktivieren, die Genehmigung des Projekts veranlassen und mit der für die Abrechnung zuständigen Person abstimmen, wie das private Angebot im Marketplace angenommen wird.
  • Die Vertex AI API (aiplatform.googleapis.com) aktivieren, das Modell in Model Garden freischalten und dabei die Nutzungsbedingungen für das Modell akzeptieren.
  • Falls eine Richtlinie deiner Organisation den Modellzugriff einschränkt, das Modell in dieser Richtlinie zulassen.
  • Dem Nutzer- oder Dienstkonto, das die Anfragen sendet, die Berechtigung zum Aufruf des Modells erteilen, etwa durch Zuweisung der Rolle roles/aiplatform.user.

Sobald das Projekt bereit ist, bitte die für die Administration zuständige Person um die Projekt-ID.

Deinen ersten API-Aufruf ausführen

Installiere für die lokale Entwicklung die Google Cloud CLI und melde dich mit dem Google-Konto an, das Zugriff auf dein Projekt hat:

gcloud auth application-default login

Rufe ein Zugriffstoken in dem Terminal ab, von dem aus du die Anfrage senden möchtest:

export GOOGLE_CLOUD_ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"

Wenn das Zugriffstoken abläuft, führe diesen Befehl erneut aus. Mit deinen gespeicherten Anmeldedaten erhältst du ein neues Token.

Sende die Anfrage mit cURL oder dem OpenAI SDK. Ersetze dabei your-project-id durch deine Projekt-ID.

Anfrage an die Responses API über Google Cloud
PROJECT_ID="your-project-id"
PROJECT_URL="https://aiplatform.googleapis.com/v1/projects/$PROJECT_ID"

curl --fail-with-body "$PROJECT_URL/locations/global/publishers/openai/v1/responses" \
  -H "Authorization: Bearer $GOOGLE_CLOUD_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-luna",
    "input": "Write a one-sentence bedtime story about a unicorn.",
    "store": false
  }'

Wenn du Zugriffstoken über die Authentifizierungsbibliothek von Google abrufen möchtest, statt sie im Terminal zu exportieren, folge der Einstiegsanleitung von Google. Sie erklärt, wie du Application Default Credentials (ADC) verwendest und API-Fehler behebst.

Verfügbarkeit der Funktionen

Die Tabelle zeigt, welche Funktionen Google Cloud und die direkt von OpenAI angebotene API unterstützen.

FunktionOpenAI APIGoogle Cloud

API-Anfragen

TextgenerierungVerfügbarVerfügbar
Antworten per Streaming über HTTP (SSE)VerfügbarVerfügbar
Endpunkt der Responses APIVerfügbarVerfügbar
Angaben zum Tokenverbrauch der AntwortVerfügbarVerfügbar
Endpunkt zum Zählen von EingabetokenVerfügbarNicht verfügbar
WebSocket-Verbindungen in EchtzeitVerfügbarNicht verfügbar
Anfragen im HintergrundVerfügbarNicht verfügbar
Fortsetzen von HintergrundstreamsVerfügbarNicht verfügbar
Chat Completions APIVerfügbarNicht verfügbar
StapelverarbeitungVerfügbarNicht verfügbar

Ausgabe und Reasoning

Strukturierte Ausgaben mit JSON SchemaVerfügbarVerfügbar
JSON-ModusVerfügbarVerfügbar
Reasoning-AufwandVerfügbarVerfügbar
Verschlüsseltes ReasoningVerfügbarVerfügbar
Reasoning-ZusammenfassungenVerfügbarNicht verfügbar

Tools und Integrationen

Clientseitige FunktionsaufrufeVerfügbarVerfügbar
Parallele ToolaufrufeVerfügbarVerfügbar
Strukturierte FunktionsargumenteVerfügbarVerfügbar
Benutzerdefinierte ToolsVerfügbarVerfügbar für freie Eingaben oder für Eingaben, die durch reguläre Ausdrücke eingeschränkt sind
Clientseitige Tool-SucheVerfügbarVerfügbar
Clientseitig ausgeführtes MCP und Tools mit NamensräumenVerfügbarVerfügbar
Clientseitiges Shell-ToolVerfügbarVerfügbar
Gehostete WebsucheVerfügbarNicht verfügbar
Gehostete Dateisuche und VektorspeicherVerfügbarNicht verfügbar
Gehostete CodeausführungVerfügbarNicht verfügbar
Serverseitiges Remote-MCPVerfügbarNicht verfügbar

Dokumente und Medien

Textextraktion aus PDF-DateienVerfügbarVerfügbar
Inline-BildeingabeVerfügbarVerfügbar
BildgenerierungVerfügbarNicht verfügbar

Gesprächszustand

Gespeicherte Gespräche fortsetzenVerfügbarVerfügbar
Gespräche ohne gespeicherten Zustand fortsetzenVerfügbarVerfügbar
Kontextverdichtung für GesprächeVerfügbarVerfügbar
Explizite Steuerung des Prompt-CachesVerfügbarVerfügbar

Datenaufbewahrung

Deine Prompts und Antworten werden nicht zum Training von OpenAI-Modellen verwendet. Die Aufbewahrungsdauer beträgt standardmäßig bis zu 30 Tage.

Wenn für dich die Option „Keine Datenaufbewahrung“ (ZDR) erforderlich ist, wende dich während des Onboardings an deine Ansprechperson bei OpenAI oder Google Cloud. Warte auf die Bestätigung, dass ZDR für dich unterstützt wird. Mit der Einstellung store: false in einer Anfrage wird ZDR nicht aktiviert.