الملفات والدفعات

تحميل ملف

تحميل ملف دفعات (batch)، أو مرجع صورة، أو ملف بتنسيق Anthropic.

POST
/v1/files

أغراض الملفات

  • ملفات الدفعات (Batch files): استخدم purpose=batch لـ /v1/batches.
  • ملفات الصور/المراجع: استخدم purpose=user_data أو purpose=vision لطلبات الصور المدعومة بملفات.
  • ملفات Anthropic: أضف الترويسة anthropic-beta: files-api-2025-04-14.

الحدود

الغرضالحد الأقصى للحجم
batch200 MiB
user_data, vision50 MiB
ملفات Anthropic500 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
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 وترويسة الإصدار التجريبي عند الحاجة).

الاستجابة

200 OK
{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

حقول هامة

idstring
معرف الملف (File ID).
purposestring
الغرض المخصص للملف. تقبل عمليات التحميل batch أو user_data أو vision.
bytesinteger
حجم الملف بالبايت.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

الترويسات

anthropic-beta?string

قم بتضمين files-api-2025-04-14 لاستخدام وضع Anthropic Files API.

جسم الطلب

multipart/form-data

الاستجابة

application/json

application/json

application/json

application/json