Teks

Compact Response

Memadatkan percakapan panjang menjadi lebih singkat untuk permintaan Responses berikutnya.

POST
/v1/responses/compact

Gambaran Umum

Memadatkan input dari percakapan yang panjang dan mengembalikan objek response.compaction. Array output-nya menampung item-item yang akan dikirim sebagai input untuk permintaan Buat Respons Anda berikutnya. Kirimkan item yang dikembalikan tanpa perubahan, dan tetap gunakan model yang sama: item compaction dienkripsi, dan model lain mungkin tidak dapat menerimanya.

  • model harus mencantumkan openai_responses di dalam accepted_request_formats. Jika tidak, permintaan akan mengembalikan 400.
  • stream tidak didukung pada endpoint ini. stream: true akan mengembalikan 400.
  • Permintaan ini ditagih berdasarkan penggunaan token seperti permintaan Responses lainnya.

Codex CLI menggunakan endpoint ini untuk pemadatan jarak jauh.

Contoh

Permintaan

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

Contoh respons

Respons

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

Bidang penting

objectstring
Selalu response.compaction.
outputarray
Item-item yang telah dipadatkan. Teruskan sebagai input untuk permintaan berikutnya tanpa perubahan.
usageobject
Penggunaan token dari permintaan pemadatan.

Error

Error menggunakan objek error bergaya OpenAI: 400 untuk bidang yang tidak valid atau model tanpa format Responses, 401 untuk kunci yang tidak valid, 402 untuk saldo tidak mencukupi, dan 503 ketika model tidak dapat melayani permintaan saat ini. Lihat Menangani error API.

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.

Nilai yang tersedia

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

Body permintaan

application/json

Respons

application/json

application/json

application/json

application/json