الضغط في Claude Messages API: مساران beta، الكتلة الموقعة وسطر الفوترة
الضغط يتطلب خطوة أخذ عينات إضافية وليس أرخص تلقائيًا
أطلقت Anthropic واجهة API للضغط في beta في 2026-02-05 (تلخيص بمجرد بلوغ عتبة) وأضافت الضغط عند الطلب في 2026-09-14: أرسل معامل الضغط على المستوى الأعلى، ويعيد API كتلة ضغط موقعة. لا يمكن للمسارين أن يشتركا في طلب واحد؛ يجب أن تأتي الكتلة الموقعة أولًا في messages، وتصف الوثائق ترك الرسائل الملخّصة أمامها بأنه 400؛ ويحدد usage.iterations التكلفة الفعلية للنداء؛ كما تُبيّن الوثائق كيف يعمل الضغط مع التخزين المؤقت للـ prompt.
آخر تحديث 2026-11-15
Claude وGPT والنماذج الصينية على مفتاح واحد، والفوترة حسب token؛ راجع /models لمعرفة النماذج القابلة للاستدعاء.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربع نقاط رئيسية
ترويسان beta مختلفان
ضغط العتبة يستخدم compact-2026-01-12، ويُضبط داخل context_management.edits بنوع إدخال compact_20260112؛ أما الضغط عند الطلب فيستخدم compact-2026-09-04 مع معامل الضغط على المستوى الأعلى. الصياغة الرسمية: لا يمكن إرسال `compaction` و`context_management` في الطلب نفسه.
المُشغّل الافتراضي لمسار العتبة
جدول المعاملات الرسمي: القيمة الافتراضية لـ trigger هي {"type": "input_tokens", "value": 150000}، وinput_tokens هو نوع المُشغّل المدعوم الوحيد، ويجب ألا تقل قيمة value عن 50,000 tokens. بمجرد أن ينطلق، يكتب API ملخصًا، ويضعه في كتلة ضغط، ويواصل الاستجابة بالسياق المضغوط.
الكتلة الموقعة في موضع خاطئ تعني 400
يعيد مسار الضغط عند الطلب كتلة ضغط موقعة واحدة. الصياغة الرسمية: إذا بقيت أي رسائل أمام الكتلة، يعيد الطلب خطأ 400 (`compaction_block_misplaced`). أرسل الكتلة أولًا في messages، بدلًا من الأدوار التي تلخّصها، واحتفظ بها كما أُعيدت تمامًا بما في ذلك توقيعها. في المقابل، تأتي كتلة العتبة بعد المحتوى الذي لخّصته.
لماذا تُفوتر بشكل منفصل
الصياغة الرسمية: يتطلب الضغط خطوة أخذ عينات إضافية، تُحتسب ضمن حدود معدل الطلبات والفوترة. تضيف الاستجابة إدخالًا من النوع compaction إلى usage.iterations؛ ولا يتضمنه الحقلان input_tokens وoutput_tokens على المستوى الأعلى، لذا يطلب منك المزوّد جمع القيم عبر iterations لمعرفة التكلفة الحقيقية للنداء.
ما هو
الضغط من جانب الخادم: عندما يبلغ الطلب العتبة التي ضبطتها، يكتب Claude ملخص المحادثة بنفسه ويعيده داخل كتلة ضغط؛ وفي الطلبات اللاحقة، يُسقط API كل كتلة محتوى قبل تلك الكتلة ويواصل من الملخص. وتقدّمه الوثائق بديلًا عن شيفرة التلخيص من جانب العميل: فالملخص يُكتب على الخادم، لذا لا تحتاج إلى شيفرة تلخيص خاصة بك. وتذكر حالتين للاستخدام: محادثة متعددة الأدوار يواصل الناس تشغيلها في نافذة واحدة لمدة طويلة، وprompts موجّهة نحو المهام تحتاج إلى قدر كبير من أعمال المتابعة (غالبًا استخدام الأدوات) قد تتجاوز نافذة السياق.
ما الذي حدث
كلا التاريخين مذكوران حرفيًا في ملاحظات الإصدار الرسمية لـ API. 2026-02-05: دخل API الضغط مرحلة beta، موفّرًا تلخيصًا للسياق من جهة الخادم للمحادثات اللانهائية عمليًا، ويذكر البند أنه كان متاحًا على Opus 4.6. 2026-09-14: أصبح Messages API قادرًا الآن على ضغط محادثة عند الطلب، وهو في مرحلة beta مع ترويسة beta المسماة compact-2026-09-04؛ أرسل معامل compaction العلوي، ويعيد API كتلة compaction موقّعة، وفي الطلبات اللاحقة تعيد إرسال تلك الكتلة بدلًا من تلك الرسائل. ينتج المسار عند الطلب كتلة موقّعة واحدة ولا ينتج ردًا (stop_reason هي compaction)؛ يمكن أن يعمل ذلك الطلب في الخلفية بينما تستمر المحادثة مع السجل الكامل، ويمكن الاحتفاظ بالأدوار الأخيرة كلمة بكلمة بعد الملخص.
الجدول الزمني
2026-02-05: تقول ملاحظات الإصدار الرسمية إن واجهة API للضغط دخلت مرحلة beta مع تلخيص السياق من جانب الخادم للمحادثات اللانهائية فعليًا، ويذكر البند أنها كانت متاحة على Opus 4.6 - أول beta للضغط من جانب الخادم.
2026-09-14: تضيف الصفحة نفسها الضغط عند الطلب (ترويسة beta: compact-2026-09-04): معامل compaction على المستوى الأعلى، وكتلة موقعة، وتلخيص في الخلفية، والأدوار الحديثة محفوظة حرفيًا بعد الملخص.
تم حفظ وثائق .md الرسمية وملاحظات إصدار API، وتم التحقق حرفيًا من كل معامل وقيمة افتراضية ورمز خطأ مذكور أعلاه؛ إذ تذكر قائمة المنصات المدعومة الرسمية لمسار الضغط عند الطلب Google Cloud وليس Amazon Bedrock، بينما تذكر قائمة مسار العتبة أيضًا Amazon Bedrock.
مؤكد مقابل ما يجب الانتباه إليه
مؤكد في الوثائق
حرفيًا في الصفحات الرسمية: القيمة الافتراضية لـ trigger هي 150000، على ألا تقل القيمة عن 50,000؛ input_tokens هو نوع المشغّل الوحيد المدعوم؛ سلسلة instructions غير الفارغة تحل محل prompt التلخيص الافتراضي بالكامل (حتى 16,384 حرفًا في مسار الضغط عند الطلب)؛ القيمة الافتراضية لـ pause_after_compaction هي false؛ يتطلب الضغط خطوة أخذ عينات إضافية تسهم في حدود معدل الطلبات والفوترة؛ لا يتضمن الاستخدام على المستوى الأعلى تكرار الضغط، ويجب عليك جمع التكرارات؛ ترك الرسائل الملخّصة أمام الكتلة الموقّعة يؤدي إلى خطأ 400 بالرمز compaction_block_misplaced؛ لا يمكن الجمع بين الضغط وcontext_management في طلب واحد؛ تتجاهل نقطة نهاية عدّ token معامل compaction؛ تختفي الصور والمستندات وكتل container_upload وعناوين URL المجلوبة داخل النطاق الملخّص بمجرد أن تحل الكتلة محلها.
⚠️ انتبه
المقولة الشائعة في المجتمع بأن الضغط يجعل كل طلب لاحق أكثر تكلفة لا يمكن تأكيدها كحقيقة. يقول المزوّد إن الضغط يضيف خطوة أخذ عينات تُحتسب في الفوترة، ويقول في الوثيقة نفسها إن الضغط يعمل جيدًا مع التخزين المؤقت للـ prompt، مع إظهار نقطة توقف cache_control على الكتلة والتوصية بنقطة توقف عند نهاية system prompt حتى يظل تخزين system prompt المؤقت صالحًا؛ ويقول أيضًا إن إعادة تطبيق كتلة ضغط سابقة لا تكلّف تكلفة ضغط إضافية. النسخة الدقيقة: للضغط تكلفة، وما إذا كان مجديًا يعتمد على أين تقع نقاط توقف التخزين المؤقت لديك. كذلك: كل الواجهة beta؛ فالملخص الفاشل يعيد HTTP 200 مع محتوى فارغ ويظل ذلك الاستدعاء محتسبًا في الفوترة؛ ومشكلة خادم عابرة تعيد الخطأ 529 overloaded_error القابل لإعادة المحاولة مع error.details.error_code بقيمة compaction_unavailable؛ وإرسال القيمة المتبقية من ميزانية المهمة إلى جانب الضغط يعيد 400.
أوجه الشبه والاختلاف
ما يشتركان فيه
كلاهما يلخّص من جهة الخادم، وكلاهما يعيد كتلة ضغط، وكلاهما يستخدم النموذج الموجود في طلبك لكتابة الملخص (يذكر قسم القيود الحالية أنه لا يوجد خيار لاستخدام نموذج مختلف وأرخص)، وكلاهما يضيف خطوة أخذ عينات تُحتسب ضمن حد معدل الطلبات والفوترة، وكلاهما لا يزال في beta.
أوجه الاختلاف
يختلف التفعيل: ينطلق مسار العتبة في منتصف الطلب ويضغط في الموضع نفسه، ويمكن أن ينطلق عدة مرات في استدعاء واحد (مع أدوات الخادم، يُفحص المشغّل عند بداية كل تكرار أخذ عينات)؛ أما مسار عند الطلب فهو طلب واحد تنفقه على كتابة الملخص، ولا ينتج ذلك الطلب أي رد. يختلف موضع الكتلة: تتبع كتلة العتبة المحتوى الذي لخّصته، بينما تحل كتلة موقّعة محل تلك الرسائل. تختلف المنصات أيضًا: تتضمن القائمة الرسمية لمسار عند الطلب Google Cloud وليس Amazon Bedrock، بينما تذكر قائمة مسار العتبة Amazon Bedrock أيضًا.
كيفية استخدامه
خمس خطوات. 1) اختر مسارًا: الضغط العتبي إذا أردت أن يدير API السياق داخل الطلبات العادية؛ أو معامل compaction إذا كان تطبيقك يجب أن يتحكم في وقت حدوثه، أو لا يستطيع التوقف أثناء كتابة ملخص، أو يجب أن يحتفظ بالأدوار الأخيرة وبالتفكير الخاص بها. 2) أرسل الترويسة على النحو الصحيح: يحتاج مسار عند الطلب إلى compact-2026-09-04 في الطلب الذي يطلب الملخص وفي كل طلب لاحق يحمل الكتلة الموقّعة؛ ودونها يفشل طلب الملخص بخطأ 400 يذكر ترويسة beta المفقودة، ويفشل طلب لاحق يحمل الكتلة بخطأ تحقق يقول إن compaction ليس أحد أنواع كتل المحتوى المتوقعة، ولا يذكر الترويسة إطلاقًا. 3) أعد الكتلة في مقدمة messages واحذف الأدوار الملخّصة. 4) صحّح تتبّع التكلفة لديك: اجمع usage.iterations بدلًا من قراءة الحقلين العلويين فقط. 5) تعامل مع حالة عدم وجود ملخص: عند تعريف أدوات، يستدعي النموذج أحيانًا أداة بدلًا من كتابة ملخص، وتعود الكتلة بقيمة content: null؛ والإصلاح الموثّق هو تعليمات تمنع صراحةً استدعاءات الأدوات.
على QCode
الضغط معامل في Messages API وترويسة beta، وليس مفتاح تبديل نعرضه. تفسّر Anthropic المعامل، ولا نقدّم أي وعد نيابة عنها. جميع النماذج في قائمة الدعم الرسمية لـ beta - claude-opus-5 وclaude-sonnet-5 وclaude-fable-5 وclaude-fable-5-1 وclaude-opus-4-8 وclaude-sonnet-4-6 - موجودة في قائمة /models العامة (تم التحقق في 2026-10-20)؛ وتذكر قائمة الدعم الرسمية أيضًا claude-mythos-5 وclaude-mythos-5-1. يُدرَج في قوائم التوافق الرسمية ما إذا كان النموذج يدعم الضغط، وهي قوائم يحتفظ بها المزوّد منفصلة لكل ترويسة beta. تُحتسب التكلفة لكل token؛ وتُدرج أسعار كل نموذج في صفحة النماذج.
الأسئلة الشائعة
هل يمكن تفعيل كلتا beta في الوقت نفسه؟
لا. تذكر الوثائق أنه لا يمكن إرسال الضغط وcontext_management في الطلب نفسه، وتضيف أن ضغط العتبة (compact_20260112) لا يمكن تشغيله على طلب يحمل كتلة موقعة. اختر مسارًا واحدًا.
هل يؤدي تفعيل الضغط إلى توفير المال؟
ليس بحد ذاته. يقول المزوّد إن الضغط يتطلب خطوة أخذ عينات إضافية تسهم في حدود معدل الطلبات والفوترة، وإن input_tokens / output_tokens على المستوى الأعلى تستثنيها، لذا عليك جمع usage.iterations. ما يصغر هو سياق الطلبات اللاحقة؛ أما ما إذا كانت المحصلة أقل تكلفة فيعتمد على نقاط توقف التخزين المؤقت وعلى أن إعادة تطبيق كتلة قديمة لا تكلّف ضغطًا إضافيًا.
أين توضع الكتلة الموقعة؟
أولًا في messages، مع إزالة الأدوار الملخّصة، وتبقى الكتلة كما أُعيدت تمامًا بما في ذلك توقيعها. تذكر الوثائق أنه إذا بقي أي منها أمام الكتلة، يعيد الطلب خطأ 400 (compaction_block_misplaced). يجب أن يحمل كل طلب لاحق يحمل الكتلة ترويسة compact-2026-09-04.
لماذا عادت الكتلة فارغة؟
غالبًا ما يكون السبب تعارض الأدوات: يذكر قسم القيود الحالية أنه عندما يتضمن الطلب أدوات، يستدعي النموذج أحيانًا أداة أثناء خطوة التلخيص الداخلية بدلًا من كتابة ملخص، ثم تحمل الاستجابة كتلة ضغط تحوي content: null. الإصلاح الموثق هو تعليمات تنص صراحة على عدم استدعاء الأدوات والرد بالنص فقط. لاحظ أيضًا أن الملخص الفاشل يظل HTTP 200 مع محتوى فارغ، ويظل محتسبًا في الفوترة ومُبلّغًا عنه في usage.iterations.
أين أجد النماذج التي تدعم الضغط؟ ما النماذج التي يمكنني تجربة ذلك عليها في QCode؟
يحتفظ المزوّد بقوائم التوافق الرسمية منفصلة لكل ترويسة بيتا: واحدة لمسار الضغط عند الطلب، وواحدة لمسار العتبة، وكل واحدة منهما تتضمن معرّفات النماذج بالصيغة التي ترسلها بها. النماذج الموجودة في قائمة دعم بيتا الرسمية - claude-opus-5 وclaude-sonnet-5 وclaude-fable-5 وclaude-fable-5-1 وclaude-opus-4-8 وclaude-sonnet-4-6 - كلها في قائمة /models العامة (تم التحقق في 2026-10-20)؛ وتذكر قائمة الدعم الرسمية أيضًا claude-mythos-5 وclaude-mythos-5-1. الضغط معامل API وليس مفتاحًا نفعّله لك؛ يمكن أن تتغير واجهات بيتا، ولا نعد بدعم طويل الأمد لأي من المسارين.
هل يمكن لنموذج أرخص كتابة الملخص أو تخطيه؟
لا استبدال. تذكر الوثائق أن النموذج المحدد في طلبك هو المستخدم في التلخيص، وأنه لا يوجد خيار لاستخدام نموذج مختلف (أرخص، مثلًا) للملخص. ما يمكنك تغييره هو التعليمات (prompt تلخيص مخصص يحل محل الإعداد الافتراضي بالكامل) وعتبة التشغيل. التحكم الكامل يعني إيقاف الضغط من جانب الخادم والتلخيص من جانب العميل، وهو تصميم مختلف.
المصادر
صفحات الضغط الرسمية من Anthropic: النظرة العامة على https://platform.claude.com/docs/en/build-with-claude/compaction (جدول اختيار طريقة الضغط وفهرس الصفحة)، وصفحة العتبة على https://platform.claude.com/docs/en/build-with-claude/compaction-threshold (المعاملات / فهم الاستخدام / التخزين المؤقت للـ prompt / القيود الحالية)، وصفحة الضغط عند الطلب على https://platform.claude.com/docs/en/build-with-claude/compaction-on-demand (طلب ملخص / الأخطاء / حساب استخدام الضغط)، إضافةً إلى ملاحظات إصدار API على https://platform.claude.com/docs/en/release-notes/api (مدخلَا 2026-02-05 و14 سبتمبر 2026 منقولان حرفيًا؛ جُلبت في اليوم نفسه بصيغة .md الرسمية، HTTP 200).
صحّح احتساب الاستخدام قبل أن تقرر الضغط
الترويسات وموضع الكتلة وصياغة الفوترة هنا تتبع الوثائق الرسمية التي جرى التحقق منها في 2026-10-20؛ ويُفسّر Anthropic المعامل، ولا نَعِد بأي سلوك نيابةً عنها. هل نفدت حصتك؟ إذا كانت لديك خطة شخصية نشطة فاشترِ باقة التعزيز، وإن لم تكن لديك فاشترِ باقات الدفع حسب الاستخدام، التي تبدأ من $4 لحصة لمرة واحدة تستخدمها خلال 7 أيام (شحن الرصيد يبدأ من $5). الأسعار على /pricing، والكتالوج الحالي على /models.
قراءات ذات صلة
دليل هندسة السياق الشامل 2026
الضغط تقنية واحدة ضمن Context Engineering؛ وتغطي تلك الصفحة المنهج لا معاملات API.
إضافة الأدوات وإزالتها في منتصف المحادثة
وتغطي تلك الصفحة كيفية بقاء تعليمات منتصف المحادثة وتغييرات الأدوات بعد التلخيص.
لا يُدعم effort عند تعطيل thinking
عائلة أخطاء thinking-block وتغيير السجل: يجب أن يظل thinking في الأدوار المحتفظ بها متسقًا أيضًا.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تستنسخ هذه الصفحة وثائق Anthropic العامة وليست تابعة لـ Anthropic. أسماء المعاملات والقيم الافتراضية ورموز الأخطاء والجمل المقتبسة وفق التحقق بتاريخ 2026-10-20؛ وقد تتغير واجهات beta دون إشعار. تعتمد جدوى الضغط على خطوة أخذ العينات الإضافية وعلى موضع نقاط توقف التخزين المؤقت، ولا تقول الوثائق أكثر من ذلك. يوفر QCode وصولًا إلى API ولا يغيّر حالة beta لواجهات Anthropic.