الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

يخدم هذا الـ endpoint أساسًا كائنات ملفات TokenLab المتوافقة مع OpenAI Batch API. عندما يفعّل الطلب وضع التوافق مع Anthropic Files، يمكن لنفس المسار أيضًا إرجاع بيانات وصفية لملفات على نمط Anthropic مرتبطة بمساحة العمل المرتبطة. بدون ترويسات Anthropic، يمكن لهذا المسار إرجاع كائن ملف دفعة أو كائن ملف صورة/مرجع من TokenLab.

​
ملاحظات

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

​
مثال

curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

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

استخدم لوحة OpenAPI التفاعلية أعلاه للحصول على المخطط الدقيق.

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

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

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

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

​
حقول مهمة

​
id
string
معرّف ملف تستخدمه APIs المرتبطة.
​
filename
string
اسم الملف الأصلي أو المُنشأ.
​
purpose
string
غرض الملف الذي يستخدمه سير العمل المالك، مثل batch أو batch_output أو user_data أو vision.