Texto

Compact Response

Compacta uma conversa longa em uma mais curta para a próxima solicitação de Responses.

POST
/v1/responses/compact

Visão geral

Compacta a entrada de uma conversa longa e retorna um objeto response.compaction. Seu array output contém os itens a serem enviados como input da sua próxima solicitação de Criar Resposta. Envie os itens retornados sem alterações e continue usando o mesmo modelo: o item compaction é criptografado e outro modelo pode não aceitá-lo.

  • O model deve listar openai_responses em accepted_request_formats. Caso contrário, a solicitação retornará 400.
  • stream não é suportado neste endpoint. stream: true retorna 400.
  • A solicitação é cobrada pelo uso de tokens, como qualquer outra solicitação de Responses.

O Codex CLI usa este endpoint para compactação remota.

Exemplo

Requisição

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

Exemplo de resposta

Resposta

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
Sempre response.compaction.
outputarray
Os itens compactados. Passe-os como input da próxima solicitação sem alterações.
usageobject
Uso de tokens da solicitação de compactação.

Erros

Os erros usam o objeto error no estilo OpenAI: 400 para um campo inválido ou um modelo sem o formato Responses, 401 para uma chave inválida, 402 para saldo insuficiente e 503 quando o modelo não pode atender à solicitação no momento. Veja Lidar com erros da API.

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Cabeçalhos

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitação. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação da solicitação ou criação de recurso persistente.

Valores permitidos

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

Corpo da requisição

application/json

Resposta

application/json

application/json

application/json

application/json