معالجة الدفعات في Claude API تناسب الطلبات التي لا تحتاج إلى إجابة فورية، مثل تقييم مجموعة اختبارات أو تحليل ملفات مستقلة. ترسل الطلبات معًا وتعالج بصورة غير متزامنة، لكن نجاح إنشاء الدفعة ليس دليلًا على نجاح كل طلب فيها. هذا شرح للتحضير لعام 2027 وفق التوثيق المرصود في 27 أكتوبر 2026، دون تثبيت أسعار أو نماذج مستقبلية.
متى تختار الدفعات؟
استخدمها عندما يمكن تأخير النتيجة وربطها لاحقًا بسجلها الأصلي. أما المحادثة التفاعلية أو مسار ينتظر المستخدم نتيجته فورًا، فالتأخير وعدم وجود بث للنتيجة قد يجعلان الطلب المباشر أنسب.
تعرض الخدمة تكلفة استخدام تعادل 50% من الأسعار القياسية، مع ضرورة مراجعة سعر النموذج والخصائص المستخدمة وقت التنفيذ. الخصم ليس رصيدًا مجانيًا أو سقف ميزانية مضمونًا؛ وقد تتجاوز المعالجة المتزامنة حد الإنفاق المضبوط قليلًا بحسب التحذير المعروض.
بناء الطلب والحدود
تضم الدفعة قائمة requests، ولكل عنصر custom_id فريد و params بمعلمات طلب Messages. يكون المعرف من حرف إلى 64 حرفًا، باستخدام الأحرف اللاتينية والأرقام والشرطة والشرطة السفلية فقط. احفظه مع سجل المصدر حتى لا تعتمد على ترتيب النتائج.
الحد 100000 طلب أو 256 ميغابايت، أيهما يتحقق أولًا. ويجب ألا يقل max_tokens عن 1؛ فلا يدعم المسار القيمة 0 لتسخين التخزين المؤقت. كما لا يدعم stream:true أو speed أو fallbacks؛ إرسال معلمة غير مدعومة يؤدي إلى خطأ تحقق.
الوقت ليس وعدًا بساعة
تنتهي معظم الدفعات خلال أقل من ساعة وفق الوصف، لكن الطلبات قد تتأخر وينتهي ما لم يعالج منها بعد 24 ساعة. راقب processing_status ثم اجلب النتائج عند انتهاء المعالجة، ولا تفسر مرور ساعة بوصفه موعد تسليم ملزمًا.
تبقى النتائج متاحة 29 يومًا من إنشاء الدفعة، لا من وقت تنزيلها. احتفظ بالنتيجة المطلوبة في نظامك ضمن احتياجات الحفظ والصلاحيات، بدل الاعتماد على بقاء رابط التنزيل مفتوحًا دائمًا.
فحص النتائج والإلغاء
تأتي النتائج بصيغة JSONL، وكل سطر نتيجة لطلب. طابق باستخدام custom_id، فقد يختلف ترتيب الخرج عن الإدخال. وافحص الحالات succeeded و errored و canceled و expired؛ فحالة ended للدفعة لا تعني أن جميع عناصرها نجحت.
لا تفوتر الطلبات المصنفة errored أو canceled أو expired وفق الوصف، لكن إلغاء الدفعة لا يمحو عملًا اكتمل سابقًا. تتحول الحالة أولًا إلى canceling، ثم ended مع احتمال نتائج جزئية. أعد فقط ما يحتاج إلى إعادة، مع حفظ المعرفات وفحص نتائج النجاح نفسها قبل استخدامها، بدل تكرار الدفعة كلها وافتراض أن الإلغاء أوقف كل طلب فورًا.
