عرض الملفات

نظرة عامةCopy Anchor Link

يخدم هذا الـ endpoint أساسًا واجهة TokenLab المتوافقة مع OpenAI Batch API، بما في ذلك مدخلات الدفعات المرفوعة وملفات الإخراج أو الخطأ المُنشأة.

عندما يفعّل الطلب وضع التوافق مع Anthropic Files، يمكن لنفس المسار أيضًا عرض ملفات على نمط Anthropic المتاحة لمساحة العمل المرتبطة.

بدون ترويسات Anthropic، يمكن أن تتضمن القائمة ملفات دفعات وملفات صور/مراجع من TokenLab. استخدم purpose=batch أو purpose=batch_output أو purpose=user_data أو purpose=vision لتضييق القائمة.

ملاحظاتCopy Anchor Link

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

curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
  -H "Authorization: Bearer sk-your-api-key"

الطلب / الاستجابةCopy Anchor Link

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

نصائح تشغيليةCopy Anchor Link

• استخدم custom_id للمصالحة اللاحقة غير المتكررة.
• توقّع output_file_id و error_file_id فقط بعد انتهاء العامل من الدفعة.

عوامل التصفيةCopy Anchor Link

• بالنسبة لملفات الدفعات ومراجع الصور، يقبل limit القيم 1–10000 (الافتراضي 10000)، ويُستخدم after للتصفح. في وضع Anthropic Files يقبل 1–1000 (الافتراضي 20)؛ استخدم after_id أو before_id، وليس كليهما.
• يمكن أن يكون purpose هو batch أو batch_output أو user_data أو vision.
• يعيد user_data و vision ملفات مراجع الصور التي أنشأها TokenLab عند توفرها.

{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
  "first_id": "file_abc123",
  "last_id": "file_abc123",
  "has_more": false
}

حقول مهمةCopy Anchor Link