حجم الطلب في Claude API يرتفع من 32 ميغابايت إلى 128 ميغابايت

رفعت Anthropic الحد الأقصى لحجم الطلب في Claude API لكل من Messages API وToken Counting API من 32 ميغابايت إلى 128 ميغابايت. ينطبق التغيير على Claude API الذي تديره Anthropic مباشرة، وقد ورد في Claude Release Notes ضمن مدخل 28 أكتوبر.

ما الذي يغيّره حجم الطلب البالغ 128 ميغابايت في Claude API؟

عمليًا، المقصود هو كمية البيانات التي تتسع لها استدعاءة واحدة لـ POST /v1/messages قبل أن ترد الواجهة بالخطأ 413 request_too_large. يُحتسب ضمن الحد الطلب كاملًا: النص، وسجل المحادثة، والصور وملفات PDF المرسلة بترميز base64.

بحسب توثيق الرؤية، يمكن أن يصل حجم الصورة الواحدة إلى 10 ميغابايت (بعد ترميز base64)، ويتسع طلب API واحد لما يصل إلى 600 صورة (100 صورة للنماذج ذات نافذة سياق بحجم 200 ألف توكن). مع الحد القديم، كانت بضع صور كبيرة كفيلة باستنفاد 32 ميغابايت قبل الاقتراب من حد عدد الصور بكثير. الآن صار الهامش أكبر بأربع مرات.

والأمر نفسه مع ملفات PDF. بحسب صفحة دعم PDF، يشمل الطلب الواحد ما يصل إلى 600 صفحة (100 صفحة عندما تكون نافذة سياق الطلب أقل من مليون توكن)، وكلا الحدين، عدد الصفحات والحجم، ينطبقان على الطلب كاملًا. صار إرسال العقود الطويلة أو المستندات الممسوحة ضوئيًا المليئة بالرسومات، مثل تلك التي يستهدفها Claude for Legal، دفعة واحدة أسهل الآن.

أين تنطبق الحدود الجديدة؟

فقط على Claude API الذي تديره Anthropic (ما يُعرف بالواجهة «first-party»). يبدو الجدول الحالي من نظرة عامة على API هكذا:

نقطة النهاية	الحد الأقصى لحجم الطلب
Messages, Token Counting	128 MB
Message Batches API	256 MB
Files API	500 MB
Sessions, Agents, Environments	32 MB

على المنصات الأخرى، الحدود مختلفة:

1. Amazon Bedrock: ‏20 ميغابايت.
2. Claude Models on Google Cloud (بإدارة Google): ‏30 ميغابايت.
3. Claude Platform on AWS وClaude Models on Google Cloud (بإدارة Anthropic) وMicrosoft Foundry: يبقى Messages وToken Counting عند 32 ميغابايت.

معلومة طريفة من وصف أخطاء API: على Claude API، تُعيد Cloudflare الخطأ 413 قبل أن يصل الطلب أصلًا إلى خوادم الواجهة.

هل انتهى زمن الالتفاف عبر Files API؟

ليس بالضرورة. ما زال التوثيق يوصي بإرسال ملفات PDF الكبيرة والصور الكثيرة عبر Files API والإشارة إليها عبر file_id. هناك يمكن أن يصل حجم الملف الواحد إلى 500 ميغابايت، وتحصل المؤسسة كلها على 1 تيرابايت من المساحة.

وهناك أيضًا بعض القيود التي لا يغيّرها الحد الأكبر:

1. عندما يحتوي الطلب على أكثر من 20 صورة، تخضع كل صورة لحد أكثر صرامة على الأبعاد. ينصح التوثيق بألا يتجاوز الضلع الأطول 3000 بكسل، أو بالاكتفاء بـ 20 كتلة من الصور والمستندات.
2. قد تملأ ملفات PDF الكثيفة نافذة السياق قبل بلوغ حد الصفحات، حتى مع Files API.
3. يبقى الوكلاء في Claude Managed Agents ‏(Sessions وAgents وEnvironments) عند 32 ميغابايت.

(حجم الطلب ليس هو التكلفة: كل صورة وكل صفحة PDF تتحول إلى توكنات، لذا يستحق الأمر أن نلقي نظرة على ما نستهلكه فعلًا، كما في قياساتي لاستهلاك التوكنات في Claude Code.)

ما الذي ينبغي الانتباه إليه؟

أولًا، المنصة. إذا كنا نستخدم Claude عبر Bedrock أو Google Cloud أو Foundry، فلم يتغير شيء، وقد يتلقى الكود الذي يعمل على Claude API الخطأ 413 هناك.

ثانيًا، عدّ التوكنات. ينطبق حد 128 ميغابايت أيضًا على Token Counting API، لذا يمكننا عدّ توكنات الطلب الكبير قبل إرساله.

ثالثًا، غياب التفاصيل. مدخل Release Notes جملة واحدة فقط، ولا يوضح لماذا ارتفع الحد الآن تحديدًا، ولا ما إذا كانت الحدود على منصات الشركاء ستتغير بالمثل.

الأسئلة الشائعة

ما الحد الأقصى لحجم الطلب في Claude API؟

على Claude API الذي تديره Anthropic: ‏128 ميغابايت لـ Messages وToken Counting، و256 ميغابايت لـ Message Batches، و500 ميغابايت لـ Files API. أما Sessions وAgents وEnvironments فحدها 32 ميغابايت.

ماذا يعني الخطأ 413 request_too_large في Claude API؟

يعني أن الطلب تجاوز حد البايتات لنقطة النهاية المعنية. الحل هو تصغير الصور، أو تقسيم المستند، أو رفع الملفات عبر Files API والإشارة إليها عبر file_id.

هل يعمل حد 128 ميغابايت على Amazon Bedrock؟

لا. بحسب التوثيق، حد Bedrock هو 20 ميغابايت، وحد Claude Platform on AWS هو 32 ميغابايت لـ Messages وToken Counting.

كم صفحة PDF يمكن إرسالها إلى Claude في طلب واحد؟

ما يصل إلى 600 صفحة، أو ما يصل إلى 100 صفحة عندما تكون نافذة سياق الطلب أقل من مليون توكن. ويجب أن يتسع الطلب كاملًا ضمن حد الحجم أيضًا.