Skip to main content
POST

Autorisierung

string
erforderlich
##Alle APIs erfordern eine Bearer-Token-Authentifizierung##API-Key erhalten:Besuchen Sie die Seite zur API-Key-Verwaltung, um Ihren API-Key zu erhaltenIm Anfrage-Header hinzufügen:

Body

string
Standard:"gpt-5.2-pro"
erforderlich
ModellnameUnterstützte Modelle umfassen:
  • gpt-5.2-pro
  • gpt-5.2-codex
  • qwen3.8-max
  • Weitere Modelle folgen in Kürze …
array
erforderlich
Liste der EingabeinhalteEingabe-Array, jedes Element enthält die Felder role und content.💡 Schnellausfüllen (Try-it-Bereich):
  1. Klicken Sie auf „+ Add an item”, um ein Eingabeelement hinzuzufügen
  2. Eingabe role: user (Benutzernachricht), assistant (KI-Antwort) oder system (Systemanweisung)
  3. content Content-Blöcke hinzufügen (kann Text und Bilder enthalten)
number
Steuert die Zufälligkeit der Ausgabe, Bereich 0–2
  • Niedrigere Werte (z. B. 0.2) führen zu deterministischerer Ausgabe
  • Höhere Werte (z. B. 1.8) führen zu zufälligerer Ausgabe
Standard: 1.0
integer
Maximale Anzahl der zu generierenden TokensVerschiedene Modelle haben unterschiedliche maximale Grenzwerte, bitte beachten Sie die jeweilige Modelldokumentation
boolean
Ob Streaming-Ausgabe verwendet werden soll
  • true: Streaming-Antwort (SSE-Format)
  • false: vollständige Antwort auf einmal zurückgeben
Standard: false
number
Nucleus-Sampling-Parameter, Bereich 0–1Steuert die Vielfalt des generierten Texts, empfohlen als Alternative zu temperatureStandard: 1.0
array
Tool-Liste zur Erweiterung der ModellfähigkeitenUnterstützte Tool-Typen:
  • Websuche (web_search): Echtzeit-Suche nach Internet-Informationen
  • Dateisuche (file_search): Suche im Inhalt hochgeladener Dateien
  • Function Calling (function): Aufruf benutzerdefinierter Funktionen
  • Remote MCP (remote_mcp): Verbindung zu Remote-Diensten des Model Context Protocol
Beispiel: [{"type": "web_search"}]

Response

string
Eindeutiger Identifikator der Antwort
string
Objekttyp, fest response
integer
Zeitstempel der Erstellung
string
Der tatsächlich verwendete Modellname
array
Liste der generierten Antworten
object
Statistik zur Token-Nutzung

Anwendungsbeispiele

Nur-Text-Eingabe

Verwendung des Websuche-Tools

cURL Example

Bildverständnis

Analyse mehrerer Bilder

Base64-codiertes Bild

Verwendung des Dateisuche-Tools

Verwendung von Function Calling

Verwendung von Remote MCP

Kombination mehrerer Tools

Spezifikationen der Content-Typen

input_text

Texteingabe-Typ Eigenschaften:
  • type: fest "input_text"
  • text: Textinhalt (String)

input_image

Bildeingabe-Typ Eigenschaften:
  • type: fest "input_image"
  • image_url: Bild-URL oder Base64-codiertes Data-URI
Unterstützte Bildformate:
  • JPEG
  • PNG
  • GIF
  • WebP
Größenbeschränkungen für Bilder:
  • Maximale Dateigröße: 20 MB
  • Empfohlenes Seitenverhältnis: nicht mehr als 2048x2048 Pixel

Details zur Tool-Nutzung

Websuche

Das Websuche-Tool ermöglicht es dem Modell, in Echtzeit auf Internet-Informationen zuzugreifen. Konfigurationsbeispiel:
Anwendungsfälle:
  • Abruf der neuesten Nachrichten und aktuellen Ereignisse
  • Echtzeit-Daten erhalten (Aktien, Wetter, Wechselkurse usw.)
  • Suche nach aktueller technischer Dokumentation
  • Überprüfung von Faktinformationen

Dateisuche

Das Dateisuche-Tool ermöglicht es dem Modell, relevante Informationen in hochgeladenen Dokumenten zu suchen. Konfigurationsbeispiel:
Anwendungsfälle:
  • Analyse interner Unternehmensdokumente
  • Suche in technischen Spezifikationen und Handbüchern
  • Abfragen zu Verträgen und Rechtsdokumenten
  • Q&A-Systeme auf Wissensbasis

Function Calling

Definieren Sie benutzerdefinierte Funktionen, damit das Modell externe APIs aufrufen oder bestimmte Operationen ausführen kann. Vollständiges Konfigurationsbeispiel:
Parameterbeschreibungen:
  • name: Funktionsname (erforderlich)
  • description: Funktionsbeschreibung (erforderlich)
  • parameters: Parameterdefinition im JSON-Schema-Format
    • type: Parametertyp
    • properties: Definitionen der Parametereigenschaften
    • required: Liste der erforderlichen Parameter
Anwendungsfälle:
  • Aufruf von Drittanbieter-APIs
  • Ausführen von Datenbankabfragen
  • Auslösen von Geschäftsprozessen
  • Integration mit internen Systemen

Remote MCP

Verbindung zu Remote-Diensten des Model Context Protocol (MCP) zur Erweiterung der Modellfähigkeiten. Konfigurationsbeispiel:
Parameterbeschreibungen:
  • url: MCP-Serveradresse (erforderlich)
  • auth_token: Authentifizierungs-Token (optional)
  • timeout: Timeout in Sekunden, Standard 30 Sekunden
Anwendungsfälle:
  • Verbindung zu KI-Diensten auf Enterprise-Ebene
  • Verwendung domänenspezifischer Modelle
  • Zugriff auf geschützte Datenquellen
  • Integration verteilter KI-Systeme

Antwortformat bei Tool-Nutzung

Wenn das Modell Tools verwendet, enthält das Antwortformat Informationen zum Tool-Aufruf:
Ablauf eines Tool-Aufrufs:
  1. Modell erhält Benutzereingabe
  2. Analysiert, ob Tools benötigt werden
  3. Falls ja, gibt eine Tool-Aufrufanforderung zurück
  4. Client führt den Tool-Aufruf aus
  5. Gibt die Tool-Ergebnisse an das Modell zurück
  6. Modell generiert die endgültige Antwort

Wichtige Hinweise

  1. Anforderungen an Bild-URLs:
    • Muss eine öffentlich zugängliche URL sein
    • Oder im Base64-codierten Data-URI-Format
  2. Token-Abrechnung:
    • Bilder verbrauchen Tokens entsprechend ihrer Auflösung
    • Bilder mit hoher Auflösung werden automatisch verkleinert, um Kosten zu optimieren
    • Tool-Aufrufe verbrauchen ebenfalls zusätzliche Tokens
  3. Reihenfolge des Inhalts:
    • Die Reihenfolge der Elemente im content-Array beeinflusst das Verständnis des Modells
    • Empfohlen, Textanweisungen zuerst zu platzieren, dann Bilder
  4. Multimodale Kombinationen:
    • In einer Anfrage können mehrere Texte und Bilder gemischt werden
    • Mehrfach-Dialoge mit Kontext-Kohärenz werden unterstützt
  5. Einschränkungen der Tool-Nutzung:
    • Bei gleichzeitiger Verwendung mehrerer Tools wählt das Modell intelligent das am besten geeignete Tool aus
    • Function Calling erfordert klare Funktionsdefinitionen und Parameterbeschreibungen
    • Ergebnisse der Websuche können regional und zeitlich begrenzt sein
  6. API-Kompatibilität:
    • Vollständig kompatibel mit dem Format der OpenAI Responses API
    • Nahtlose Migration bestehenden OpenAI-Codes
    • Unterstützt alle Tool-Erweiterungsfunktionen von OpenAI