TokenLab

Văn bản

Compact Response

Nén một cuộc hội thoại dài thành một cuộc hội thoại ngắn hơn cho yêu cầu Responses tiếp theo.

POST
/v1/responses/compact

Tổng quan

Nén đầu vào của một cuộc hội thoại dài và trả về một đối tượng response.compaction. Mảng output của nó chứa các mục để gửi làm input cho yêu cầu Tạo phản hồi tiếp theo của bạn. Hãy gửi các mục được trả về mà không thay đổi gì và tiếp tục sử dụng cùng một model: mục compaction đã được mã hóa và các model khác có thể sẽ không chấp nhận nó.

  • model phải liệt kê openai_responses trong accepted_request_formats. Nếu không, yêu cầu sẽ trả về 400.
  • stream không được hỗ trợ trên endpoint này. stream: true sẽ trả về 400.
  • Yêu cầu được tính phí dựa trên mức sử dụng token giống như bất kỳ yêu cầu Responses nào khác.

Codex CLI sử dụng endpoint này để nén từ xa.

Ví dụ

Yêu cầu

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

Ví dụ phản hồi

Phản hồi

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

Các trường quan trọng

objectstring
Luôn là response.compaction.
outputarray
Các mục đã được nén. Hãy truyền chúng dưới dạng input của yêu cầu tiếp theo mà không thay đổi gì.
usageobject
Mức sử dụng token của yêu cầu nén.

Lỗi

Các lỗi sử dụng đối tượng error theo phong cách OpenAI: 400 cho trường không hợp lệ hoặc model không có định dạng Responses, 401 cho khóa không hợp lệ, 402 cho số dư không đủ và 503 khi model không thể phục vụ yêu cầu tại thời điểm hiện tại. Xem Xử lý lỗi API.

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Header

X-TokenLab-Delivery-Policy?string

Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.

Giá trị hợp lệ

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

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json