TokenLab

텍스트

Compact Response

긴 대화를 다음 Responses 요청을 위해 더 짧게 압축합니다.

POST
/v1/responses/compact

개요

긴 대화의 입력을 압축하고 response.compaction 객체를 반환합니다. 이 객체의 output 배열에는 다음 응답 생성 요청의 input으로 보낼 항목들이 포함되어 있습니다. 반환된 항목을 변경하지 말고 그대로 전송해야 하며, 동일한 모델을 계속 사용하십시오. compaction 항목은 암호화되어 있으므로 다른 모델에서는 이를 수용하지 못할 수 있습니다.

  • model의 accepted_request_formats에 openai_responses가 포함되어 있어야 합니다. 그렇지 않으면 요청 시 400 오류가 반환됩니다.
  • 이 엔드포인트에서는 stream을 지원하지 않습니다. stream: true 설정 시 400 오류가 반환됩니다.
  • 요청은 다른 Responses 요청과 마찬가지로 토큰 사용량에 따라 과금됩니다.

Codex CLI는 원격 압축을 위해 이 엔드포인트를 사용합니다.

예시

요청

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

응답 예시

응답

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

주요 필드

objectstring
항상 response.compaction입니다.
outputarray
압축된 항목들입니다. 다음 요청의 input으로 변경 없이 전달하십시오.
usageobject
압축 요청의 토큰 사용량입니다.

오류

오류는 OpenAI 스타일의 error 객체를 사용합니다. 잘못된 필드나 Responses 형식을 지원하지 않는 모델의 경우 400, 유효하지 않은 키의 경우 401, 잔액 부족의 경우 402, 모델이 현재 요청을 처리할 수 없는 경우 503 오류가 발생합니다. API 오류 처리를 참조하십시오.

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

헤더

X-TokenLab-Delivery-Policy?string

요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.

허용 값

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

요청 본문

application/json

응답

application/json

application/json

application/json

application/json