رفع ملف

​

نظرة عامة

​

أوضاع الملفات المدعومة

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

​

ملاحظات

• يجب أن تستخدم ملفات الإدخال الدفعي purpose=batch.
• completion_window حاليًا 24h.
• ترتيب الإخراج غير مضمون؛ يجب دائمًا المطابقة بواسطة custom_id.
• لا يتم دعم البث داخل عناصر الدفعة.

​

مثال

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"

​

الطلب / الاستجابة

​

نصائح تشغيلية

• استخدم custom_id للمصالحة غير القابلة للتغيير في الأسفل.
• توقع output_file_id و error_file_id فقط بعد أن ينهي العامل الدفعة.
• قد تختلف أسعار الدفعة عن أسعار المعالجة المتزامنة لأن قواعد الخصم لـ isBatchRequest=true تنطبق.

​

مدخلات ملفات الصور

• استخدم purpose=user_data أو purpose=vision.
• يمكنك اختيارياً تمرير model لاختيار نموذج تحرير الصور؛ القيمة الافتراضية هي gpt-image-2.
• يتم ربط file_id المُعاد بإعداد تحرير الصور المختار، ويمكن إعادة استخدامه في images[].file_id.

​

وضع Anthropic Files API

• أضف ترويسة anthropic-beta: files-api-2025-04-14 للتبديل إلى وضع Anthropic.
• في وضع Anthropic، ارفع الملف الأصلي مباشرة ولا ترسل purpose=batch.
• سيتم ربط file_id المُعاد بالقناة/مساحة العمل الرسمية نفسها الخاصة بـ Anthropic ويجب إعادة استخدامه في طلبات /v1/messages.
• إذا كنت تنوي الإشارة إلى هذا الملف داخل محتوى رسالة Anthropic، فاستمر في استخدام الترويسات الأصلية لـ Anthropic (x-api-key وanthropic-version وترويسة beta عند الحاجة).

​

مثال الاستجابة

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

​

حقول مهمة