الملفات والدفعات
استرجاع دفعة
يسترجع الحالة الحالية، العد، وملفات النتائج لدفعة.
نظرة عامة
تعتبر هذه النقطة جزءًا من واجهة برمجة التطبيقات الخاصة بالدفعات المتوافقة مع OpenAI من TokenLab. تستخدم مهام الدفعات ملفات JSONL المرفوعة، وتعمل بشكل غير متزامن، ويمكن أن تعيد ملفات الإخراج/الأخطاء لاحقًا.
ملاحظات
- يجب أن تستخدم ملفات الإدخال للدفعة
purpose=batch. completion_windowحاليًا24h.- ترتيب الإخراج غير مضمون؛ يجب دائمًا المطابقة بواسطة
custom_id. - لا يتم دعم البث داخل عناصر الدفعة.
الطلب
curl -X GET "https://api.tokenlab.sh/v1/batches/batch_abc123" \
-H "Authorization: Bearer sk-your-api-key"الطلب / الاستجابة
استخدم لوحة OpenAPI التفاعلية أعلاه للحصول على المخطط الدقيق.
نصائح تشغيلية
- استخدم
custom_idللمصالحة غير القابلة للتغيير في الأسفل. - توقع
output_file_idوerror_file_idفقط بعد أن ينهي العامل الدفعة.
الاستجابة
{
"id": "batch_abc123",
"object": "batch",
"status": "completed",
"input_file_id": "file_abc123",
"output_file_id": "file_out123",
"error_file_id": "file_err123",
"request_counts": { "total": 100, "completed": 98, "failed": 2 }
}حقول مهمة
request_countsobject
أعداد الطلبات الإجمالية والمكتملة والفاشلة والملغاة.
output_file_idstring|null
معرّف ملف تستخدمه APIs المرتبطة.
error_file_idstring|null
معرّف ملف تستخدمه APIs المرتبطة.
التفويض
BearerAuth AuthorizationBearer <token>
مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
batch_id*string
الاستجابة
application/json
application/json