Text & Chat

Kompakte Antwort

Kompaktiert eine lange Konversation in eine kürzere für die nächste Responses-Anfrage.

POST
/v1/responses/compact

Überblick

Kompaktiert die Eingabe einer langen Konversation und gibt ein response.compaction-Objekt zurück. Dessen output-Array enthält die Elemente, die als input für Ihre nächste Antwort erstellen-Anfrage gesendet werden sollen. Senden Sie die zurückgegebenen Elemente unverändert und verwenden Sie weiterhin dasselbe Modell: Das compaction-Element ist verschlüsselt und wird möglicherweise von einem anderen Modell nicht akzeptiert.

  • Das model muss openai_responses in accepted_request_formats auflisten. Andernfalls gibt die Anfrage 400 zurück.
  • stream wird von diesem Endpunkt nicht unterstützt. stream: true gibt 400 zurück.
  • Die Anfrage wird wie jede andere Responses-Anfrage nach Token-Verbrauch abgerechnet.

Codex CLI verwendet diesen Endpunkt für die Remote-Kompaktierung.

Beispiel

Anfrage

cURL
curl -X POST "https://api.tokenlab.sh/v1/responses/compact" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "input": [
      {"type": "message", "role": "user", "content": "Plan a three-day trip to Kyoto."},
      {"type": "message", "role": "assistant", "content": "Day 1: Fushimi Inari and Gion. Day 2: Arashiyama. Day 3: Kinkaku-ji and Nishiki Market."},
      {"type": "message", "role": "user", "content": "Add a tea ceremony on day 2."}
    ]
  }'

Antwortbeispiel

Antwort

200 OK
{
  "id": "resp_abc123",
  "object": "response.compaction",
  "created_at": 1706000000,
  "output": [
    {
      "type": "message",
      "role": "user",
      "content": [{"type": "input_text", "text": "Plan a three-day trip to Kyoto."}]
    },
    {
      "id": "cmp_abc123",
      "type": "compaction",
      "encrypted_content": "gAAAAAB..."
    }
  ],
  "usage": {
    "input_tokens": 120,
    "output_tokens": 30,
    "total_tokens": 150
  }
}

Wichtige Felder

objectstring
Immer response.compaction.
outputarray
Die kompaktierten Elemente. Übergeben Sie diese unverändert als input für die nächste Anfrage.
usageobject
Token-Verbrauch der Kompaktierungsanfrage.

Fehler

Fehler verwenden das error-Objekt im OpenAI-Stil: 400 für ein ungültiges Feld oder ein Modell ohne Responses-Format, 401 für einen ungültigen Schlüssel, 402 bei unzureichendem Guthaben und 503, wenn das Modell die Anfrage derzeit nicht verarbeiten kann. Siehe API-Fehler behandeln.

Autorisierung

BearerAuth
AuthorizationBearer <token>

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

Ort: header

Header

X-TokenLab-Delivery-Policy?string

Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.

Zulässige Werte

  • "auto"
  • "verified"
  • "official"

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

application/json