Texto

Compact Response

Compacta una conversación larga en una más corta para la siguiente solicitud de Responses.

POST
/v1/responses/compact

Descripción general

Compacta la entrada de una conversación larga y devuelve un objeto response.compaction. Su matriz output contiene los elementos que se deben enviar como input en su siguiente solicitud de Crear Respuesta. Envíe los elementos devueltos sin cambios y siga utilizando el mismo modelo: el elemento compaction está cifrado y es posible que otro modelo no lo acepte.

  • El model debe incluir openai_responses en accepted_request_formats. De lo contrario, la solicitud devolverá un 400.
  • stream no es compatible con este endpoint. stream: true devolverá un 400.
  • La solicitud se factura por uso de tokens al igual que cualquier otra solicitud de Responses.

Codex CLI utiliza este endpoint para la compactación remota.

Ejemplo

Solicitud

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

Ejemplo de respuesta

Respuesta

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

Campos importantes

objectstring
Siempre response.compaction.
outputarray
Los elementos compactados. Páselos como input de la siguiente solicitud sin realizar cambios.
usageobject
Uso de tokens de la solicitud de compactación.

Errores

Los errores utilizan el objeto error al estilo de OpenAI: 400 para un campo no válido o un modelo sin el formato Responses, 401 para una clave no válida, 402 para saldo insuficiente y 503 cuando el modelo no puede atender la solicitud en este momento. Consulte Manejo de errores de la API.

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Encabezados

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.

Valores permitidos

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

Cuerpo de la solicitud

application/json

Respuesta

application/json

application/json

application/json

application/json