الملفات والدفعات
تحميل ملف
تحميل ملف دفعات (batch)، أو مرجع صورة، أو ملف بتنسيق Anthropic.
أغراض الملفات
- ملفات الدفعات (Batch files): استخدم
purpose=batchلـ/v1/batches. - ملفات الصور/المراجع: استخدم
purpose=user_dataأوpurpose=visionلطلبات الصور المدعومة بملفات. - ملفات Anthropic: أضف الترويسة
anthropic-beta: files-api-2025-04-14.
الحدود
| الغرض | الحد الأقصى للحجم |
|---|---|
batch | 200 MiB |
user_data, vision | 50 MiB |
| ملفات Anthropic | 500 MB |
الملفات الأكبر حجماً تُرجع الخطأ 413 request_too_large. أي purpose غير batch أو user_data أو vision يُرجع الخطأ 400 unsupported_purpose. الطلب الذي لا يحتوي على file يُرجع الخطأ 400.
تنتهي صلاحية ملف batch بعد 24 ساعة من التحميل. لتغيير ذلك، أرسل حقول النموذج expires_after[anchor]=created_at و expires_after[seconds] بقيمة تتراوح من 3600 إلى 2592000 (30 يوماً). يوضح حقل expires_at في الاستجابة وقت الانتهاء.
الطلب
curl -X POST "https://api.tokenlab.sh/v1/files" \
-H "Authorization: Bearer sk-your-api-key" \
-F "purpose=batch" \
-F "file=@batch-input.jsonl;type=application/jsonl"مدخلات ملفات الصور
يمكن لنفس المسار /v1/files تحميل ملفات مرجعية للصور من أجل /v1/images/edits.
- استخدم
purpose=user_dataأوpurpose=vision. - يمكنك اختيارياً تضمين
modelلتحديد نموذج تعديل الصور؛ القيمة الافتراضية هيgpt-image-2. - يتم ربط
file_idالمُرجع بإعدادات تعديل الصورة المحددة ويمكن إعادة استخدامه فيimages[].file_id.
وضع واجهة برمجة تطبيقات ملفات Anthropic
- أضف
anthropic-beta: files-api-2025-04-14لاستخدام ملفات Anthropic. - في وضع Anthropic، قم بتحميل الملف الأصلي مباشرة ولا ترسل
purpose=batch. - يكون
file_idالمُرجع متاحاً فقط في مساحة العمل (Workspace) الحالية ويمكن إعادة استخدامه في طلبات/v1/messages. - إذا كنت تخطط للإشارة إلى الملف الذي تم تحميله من محتوى رسالة Anthropic، استمر في استخدام الترويسات الأصلية لـ Anthropic (
x-api-keyوanthropic-versionوترويسة الإصدار التجريبي عند الحاجة).
الاستجابة
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}حقول هامة
batch أو user_data أو vision.التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
الترويسات
قم بتضمين files-api-2025-04-14 لاستخدام وضع Anthropic Files API.
جسم الطلب
multipart/form-data
الاستجابة
application/json
application/json
application/json
application/json