تتيح Files API في Claude رفع الملف مرة وإعادة استخدام معرفه بدل إرفاق المحتوى في كل طلب. لكن حد الرفع ليس حد التحليل، ومعرف الملف ليس حاجزًا بين مستخدمي التطبيق. هذا دليل للتحضير لعام 2027 وفق الوثائق المتاحة في 27 أكتوبر 2026، دون افتراض ثبات الحدود مستقبلًا.
دورة الملف من الرفع إلى الاستخدام
ارفع الملف للحصول على file_id، ثم استخدم المعرف في طلب Messages بالطريقة الملائمة لنوع المحتوى. وتتوفر عمليات سرد الملفات وقراءة بياناتها وحذفها، لكن لا يمكن تعديل الملف أو إعادة تسميته بعد الرفع؛ ولتغيير المحتوى يرفع ملف جديد.
الحد المعلن 500 ميغابايت للملف وتيرابايت واحد للتخزين لكل مؤسسة. ولا يعني نجاح رفع ملف بهذا الحجم أن نموذجًا سيقرأه داخل نافذة السياق؛ فحدود المحتوى والسياق ونوع الكتلة تبقى مستقلة.
العزل في مساحة العمل
الملفات متاحة داخل مساحة العمل التي رفعت إليها، وليست مقيدة تلقائيًا بمستخدم نهائي أو محادثة أو جلسة. وأي مفتاح لديه وصول للمساحة يستطيع الوصول إلى ملفاتها.
احتفظ بربط المستخدم بملفاته في الخادم، ولا تقبل معرفًا يرسله المستخدم باعتباره إثبات ملكية. وللتطبيقات متعددة العملاء، تعد مساحة عمل مستقلة لكل عميل حد العزل الموصوف؛ مع مفاتيح مقيدة بالمساحة المناسبة، لا الاعتماد على إخفاء المعرف.
التنزيل ليس لكل ملف
الملفات التي يرفعها التطبيق لا تدعم تنزيل محتواها عبر هذه العملية وتعيد خطأ 400 عند المحاولة. والتنزيل يخص الملفات الناتجة عن تنفيذ الكود أو المهارات عندما تبين بياناتها downloadable: true. احتفظ بنسختك الأصلية بدل استخدام الرفع كخدمة نسخ احتياطي يمكن استرجاعها.
الانتهاء والحذف والاحتفاظ
يمكن تعيين expires_in_seconds عند الرفع بين 3600 ثانية و7776000 ثانية، أي من ساعة إلى 90 يومًا، ولا يعدل لاحقًا. والملف دون انتهاء يظهر expires_at بقيمة null.
عند الانتهاء يفشل استخدام الملف في Messages ويتوقف تنزيل محتواه، لكن بياناته الوصفية قد تبقى في القائمة حتى 30 يومًا. افحص expires_at بدل اعتبار كل عنصر في القائمة قابلًا للاستخدام.
انتهاء الصلاحية ليس ضمان حذف فوري للمحتوى من جميع أنظمة الاحتفاظ؛ فقد يبقى مدة محدودة لمراجعة السلامة. والحذف لا يستعيد الملف وقد يبقى مؤثرًا في طلبات نشطة، فلا تسوّق أيًا منهما كوعد محو لحظي.
التكلفة
عمليات إدارة الملفات مجانية، لكن المحتوى المستخدم في Messages يحاسب كرموز إدخال. إعادة استخدام file_id تقلل إعادة نقل البيانات، ولا تعني تحليل الملف مجانًا في كل طلب.
