テキスト

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