文字
Compact Response
將長對話壓縮為較短的內容,以供下一個 Responses 請求使用。
概覽
壓縮長對話的輸入並返回一個 response.compaction 物件。其 output 陣列包含應作為下一個 建立回應 請求之 input 發送的項目。請將返回的項目原封不動地發送,並繼續使用相同的模型:因為 compaction 項目已加密,其他模型可能無法接受它。
model的accepted_request_formats必須包含openai_responses。否則請求將返回400。- 此端點不支援
stream。設定stream: true將返回400。 - 此請求與其他 Responses 請求一樣,會根據 token 使用量進行計費。
Codex CLI 使用此端點進行遠端壓縮。
請求
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."}
]
}'回應
{
"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
壓縮請求的 token 使用量。
錯誤
錯誤使用 OpenAI 風格的 error 物件:400 表示欄位無效或模型不支援 Responses 格式,401 表示金鑰無效,402 表示餘額不足,503 表示模型目前無法處理請求。請參閱 處理 API 錯誤。
授權
BearerAuth AuthorizationBearer <token>
API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
請求標頭
X-TokenLab-Delivery-Policy?string
單次請求傳遞策略。會覆寫 API key 與 Workspace 的預設值。系統會自動優先嘗試 TokenLab Verified,並可能在輸出、請求接受或建立持久性資源前切換至 Official 模式一次。
可選值
- "auto"
- "verified"
- "official"
請求主體
application/json
回應
application/json
application/json
application/json
application/json