النص

Compact Response

ضغط محادثة طويلة إلى محادثة أقصر لطلب Responses التالي.

POST
/v1/responses/compact

نظرة عامة

يقوم بضغط مدخلات محادثة طويلة وإرجاع كائن response.compaction. تحتوي مصفوفة output الخاصة به على العناصر التي يجب إرسالها كـ input لطلب إنشاء استجابة التالي الخاص بك. أرسل العناصر التي تم إرجاعها دون تغيير، واستمر في استخدام نفس النموذج: عنصر compaction مشفر، وقد لا يقبله نموذج آخر.

  • يجب أن يدرج model خيار openai_responses ضمن accepted_request_formats. وإلا سيعيد الطلب 400.
  • خاصية stream غير مدعومة في نقطة النهاية هذه. إرسال stream: true سيعيد 400.
  • تتم محاسبة الطلب بناءً على استهلاك الـ token مثل أي طلب 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
استهلاك الـ token لطلب الضغط.

الأخطاء

تستخدم الأخطاء كائن error بنمط OpenAI: 400 لحقل غير صالح أو نموذج لا يدعم تنسيق Responses، 401 لمفتاح غير صالح، 402 لرصيد غير كافٍ، و 503 عندما لا يتمكن النموذج من خدمة الطلب حالياً. راجع التعامل مع أخطاء API.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: 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