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.
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.
| Funktion | OpenAI API | Google Cloud |
|---|---|---|
API-Anfragen | ||
| Textgenerierung | Verfügbar | Verfügbar |
| Antworten per Streaming über HTTP (SSE) | Verfügbar | Verfügbar |
| Endpunkt der Responses API | Verfügbar | Verfügbar |
| Angaben zum Tokenverbrauch der Antwort | Verfügbar | Verfügbar |
| Endpunkt zum Zählen von Eingabetoken | Verfügbar | Nicht verfügbar |
| WebSocket-Verbindungen in Echtzeit | Verfügbar | Nicht verfügbar |
| Anfragen im Hintergrund | Verfügbar | Nicht verfügbar |
| Fortsetzen von Hintergrundstreams | Verfügbar | Nicht verfügbar |
| Chat Completions API | Verfügbar | Nicht verfügbar |
| Stapelverarbeitung | Verfügbar | Nicht verfügbar |
Ausgabe und Reasoning | ||
| Strukturierte Ausgaben mit JSON Schema | Verfügbar | Verfügbar |
| JSON-Modus | Verfügbar | Verfügbar |
| Reasoning-Aufwand | Verfügbar | Verfügbar |
| Verschlüsseltes Reasoning | Verfügbar | Verfügbar |
| Reasoning-Zusammenfassungen | Verfügbar | Nicht verfügbar |
Tools und Integrationen | ||
| Clientseitige Funktionsaufrufe | Verfügbar | Verfügbar |
| Parallele Toolaufrufe | Verfügbar | Verfügbar |
| Strukturierte Funktionsargumente | Verfügbar | Verfügbar |
| Benutzerdefinierte Tools | Verfügbar | Verfügbar für freie Eingaben oder für Eingaben, die durch reguläre Ausdrücke eingeschränkt sind |
| Clientseitige Tool-Suche | Verfügbar | Verfügbar |
| Clientseitig ausgeführtes MCP und Tools mit Namensräumen | Verfügbar | Verfügbar |
| Clientseitiges Shell-Tool | Verfügbar | Verfügbar |
| Gehostete Websuche | Verfügbar | Nicht verfügbar |
| Gehostete Dateisuche und Vektorspeicher | Verfügbar | Nicht verfügbar |
| Gehostete Codeausführung | Verfügbar | Nicht verfügbar |
| Serverseitiges Remote-MCP | Verfügbar | Nicht verfügbar |
Dokumente und Medien | ||
| Textextraktion aus PDF-Dateien | Verfügbar | Verfügbar |
| Inline-Bildeingabe | Verfügbar | Verfügbar |
| Bildgenerierung | Verfügbar | Nicht verfügbar |
Gesprächszustand | ||
| Gespeicherte Gespräche fortsetzen | Verfügbar | Verfügbar |
| Gespräche ohne gespeicherten Zustand fortsetzen | Verfügbar | Verfügbar |
| Kontextverdichtung für Gespräche | Verfügbar | Verfügbar |
| Explizite Steuerung des Prompt-Caches | Verfügbar | Verfü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.