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 請求一樣,會根據 token 使用量進行計費。

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
壓縮請求的 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