Layermod

Responses

Antworten erstellen, abrufen und löschen

POST /v1/responses

Erstellt eine Antwort mit erweiterten Funktionen wie Persistenz und Hintergrundverarbeitung.

Anfrage

Request Body
{
  "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"
  }
}
ParameterTypPflichtBeschreibung
modelstringJaModell-ID
inputstring | arrayJaText oder Nachrichten-Array
instructionsstringNeinSystem-Anweisungen
previous_response_idstringNeinVorherige Antwort-ID für Verkettung
streambooleanNeinStreaming aktivieren (Standard: false)
temperaturenumberNeinKreativität (0–2)
top_pnumberNeinNucleus-Sampling (0–1)
max_output_tokensnumberNeinMaximale Ausgabe-Tokens
storebooleanNeinAntwort in Datenbank speichern (Standard: false)
backgroundbooleanNeinAsynchron verarbeiten (Standard: false)
metadataobjectNeinBenutzerdefinierte Metadaten
providerobjectNeinAnbieter-Präferenzen

Antwort

200 OK
{
  "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

ParameterTypBeschreibung
idstringAntwort-ID (z.B. resp_abc123)

Antwort

Gleiches Format wie bei der Erstellung.

Fehlercodes

CodeBeschreibung
404Antwort nicht gefunden oder abgelaufen

DELETE /v1/responses/:id

Löscht eine gespeicherte Antwort.

Parameter

ParameterTypBeschreibung
idstringAntwort-ID

Antwort

200 OK
{
  "deleted": true
}

Fehlercodes

CodeBeschreibung
404Antwort nicht gefunden

On this page