Text & Chat

Antwort abrufen

Ruft eine gespeicherte Antwort anhand ihrer ID ab oder fragt eine Hintergrundantwort ab.

GET
/v1/responses/{id}

Überblick

Gibt eine Antwort zurück, die mit Response erstellen erstellt wurde. Verwenden Sie diesen Endpunkt, um eine background-Antwort abzufragen, bis ihr status endgültig ist, oder um eine gespeicherte Antwort erneut zu lesen.

  • Welche Antworten: Antworten, die mit store nicht auf false gesetzt wurden, sowie background-Antworten. Bei store: false speichert TokenLab nichts, das abgerufen werden könnte.
  • Aufbewahrung: TokenLab speichert eine Antwort für 24 Stunden. Einige bleiben bis zu 30 Tage lang abrufbar, verlassen Sie sich jedoch nicht darauf: Speichern Sie die Ergebnisse, die Sie benötigen. Nach Ablauf der Aufbewahrungsfrist gibt die ID einen 404-Fehler zurück.
  • Eigentümerschaft: Sie können nur Antworten lesen, die in Ihrem eigenen Konto erstellt wurden. Eine ID aus einem anderen Konto gibt einen 404-Fehler zurück, genau wie eine unbekannte ID.
  • Status: queued, in_progress, completed, incomplete, failed oder cancelled. Überprüfen Sie den status, nicht nur den HTTP-Code.

stream und starting_after gelten, solange eine Antwort noch verarbeitet wird. Eine abgeschlossene Antwort wird als JSON zurückgegeben. include und include_obfuscation werden weitergeleitet, sofern das Modell diese unterstützt.

Beispiel

Anfrage

cURL
curl -X GET "https://api.tokenlab.sh/v1/responses/resp_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

Antwortbeispiel

Antwort

200 OK
{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1706000000,
  "status": "completed",
  "model": "gpt-5.6-terra",
  "output": [
    {
      "id": "msg_abc123",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {"type": "output_text", "text": "Hello! How can I help you today?", "annotations": []}
      ]
    }
  ],
  "usage": {
    "input_tokens": 10,
    "output_tokens": 12,
    "total_tokens": 22
  }
}

Fehler

StatusCodeBedeutung
404response_not_foundDie ID ist unbekannt, gehört zu einem anderen Konto, wurde gelöscht, wurde mit store: false erstellt oder die Aufbewahrungsfrist ist abgelaufen.
502upstream_response_read_failedTokenLab konnte die Antwort nicht von dem Dienst lesen, der sie erstellt hat. Versuchen Sie es später erneut.
503response_state_unavailable, response_result_unavailableDer Antwortstatus ist vorübergehend nicht verfügbar. Versuchen Sie es später erneut.

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Pfadparameter

id*string

Antwort-ID, die von POST /v1/responses zurückgegeben wurde.

Abfrageparameter

include?array<string>

Zusätzliche Antwortfelder, die einbezogen werden sollen; werden weitergeleitet, sofern das Modell sie unterstützt.

include_obfuscation?boolean

Gibt an, ob gestreamte Events Obfuskationsfelder enthalten; werden weitergeleitet, sofern das Modell dies unterstützt.

stream?boolean

Gibt an, ob die Antwort als Event-Stream abgerufen werden soll. Gilt, solange die Antwort noch läuft; eine abgeschlossene Antwort wird als JSON zurückgegeben.

starting_after?integer

Sequenznummer, ab der Streaming-Events zurückgegeben werden. Gilt nur mit stream.

Antwort

application/json

application/json

application/json

application/json