TokenLab

Texte

Compact Response

Compacte une longue conversation en une version plus courte pour la prochaine requête Responses.

POST
/v1/responses/compact

Aperçu

Compacte l'entrée d'une longue conversation et renvoie un objet response.compaction. Son tableau output contient les éléments à envoyer en tant qu'input de votre prochaine requête Créer une réponse. Envoyez les éléments renvoyés tels quels et continuez à utiliser le même modèle : l'élément compaction est chiffré et un autre modèle pourrait ne pas l'accepter.

  • Le model doit lister openai_responses dans accepted_request_formats. Sinon, la requête renvoie 400.
  • stream n'est pas pris en charge sur ce endpoint. stream: true renvoie 400.
  • La requête est facturée à l'utilisation de tokens comme toute autre requête Responses.

Codex CLI utilise ce endpoint pour la compaction à distance.

Exemple

Requête

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."}
    ]
  }'

Exemple de réponse

Réponse

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
  }
}

Champs importants

objectstring
Toujours response.compaction.
outputarray
Les éléments compactés. Transmettez-les en tant qu'input de la requête suivante sans modification.
usageobject
Utilisation des tokens pour la requête de compaction.

Erreurs

Les erreurs utilisent l'objet error de style OpenAI : 400 pour un champ invalide ou un modèle sans le format Responses, 401 pour une clé invalide, 402 pour un solde insuffisant, et 503 lorsque le modèle ne peut pas traiter la requête pour le moment. Voir Gérer les erreurs de l'API.

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

En-têtes

X-TokenLab-Delivery-Policy?string

Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.

Valeurs possibles

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

Corps de la requête

application/json

Réponse

application/json

application/json

application/json

application/json