Responses
Antworten erstellen, abrufen und löschen
POST /v1/responses
Erstellt eine Antwort mit erweiterten Funktionen wie Persistenz und Hintergrundverarbeitung.
Anfrage
{
"model": "gpt-5.4",
"input": "Was ist Quantencomputing?",
"instructions": "Antworte auf Deutsch.",
"previous_response_id": null,
"stream": false,
"temperature": 0.7,
"max_output_tokens": 1024,
"store": false,
"background": false,
"provider": {
"order": ["azure"],
"allow": ["azure", "ionos"],
"data_residency": "eu"
}
}| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
model | string | Ja | Modell-ID |
input | string | array | Ja | Text oder Nachrichten-Array |
instructions | string | Nein | System-Anweisungen |
previous_response_id | string | Nein | Vorherige Antwort-ID für Verkettung |
stream | boolean | Nein | Streaming aktivieren (Standard: false) |
temperature | number | Nein | Kreativität (0–2) |
top_p | number | Nein | Nucleus-Sampling (0–1) |
max_output_tokens | number | Nein | Maximale Ausgabe-Tokens |
store | boolean | Nein | Antwort in Datenbank speichern (Standard: false) |
background | boolean | Nein | Asynchron verarbeiten (Standard: false) |
metadata | object | Nein | Benutzerdefinierte Metadaten |
provider | object | Nein | Anbieter-Präferenzen |
Antwort
{
"id": "resp_abc123",
"object": "response",
"model": "gpt-5.4",
"status": "completed",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "Quantencomputing nutzt die Prinzipien der Quantenmechanik..."
}
]
}
],
"usage": {
"input_tokens": 12,
"output_tokens": 85,
"total_tokens": 97
},
"metadata": {},
"created_at": "2026-03-08T12:00:00.000Z",
"completed_at": "2026-03-08T12:00:01.500Z",
"error": null
}GET /v1/responses/:id
Ruft eine gespeicherte Antwort anhand ihrer ID ab.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Antwort-ID (z.B. resp_abc123) |
Antwort
Gleiches Format wie bei der Erstellung.
Fehlercodes
| Code | Beschreibung |
|---|---|
404 | Antwort nicht gefunden oder abgelaufen |
DELETE /v1/responses/:id
Löscht eine gespeicherte Antwort.
Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Antwort-ID |
Antwort
{
"deleted": true
}Fehlercodes
| Code | Beschreibung |
|---|---|
404 | Antwort nicht gefunden |