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

استرجاع دفعة

يسترجع الحالة الحالية، العد، وملفات النتائج لدفعة.

GET
/v1/batches/{batch_id}

نظرة عامة

تعتبر هذه النقطة جزءًا من واجهة برمجة التطبيقات الخاصة بالدفعات المتوافقة مع OpenAI من TokenLab. تستخدم مهام الدفعات ملفات JSONL المرفوعة، وتعمل بشكل غير متزامن، ويمكن أن تعيد ملفات الإخراج/الأخطاء لاحقًا.

ملاحظات

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

مثال

الطلب

cURL
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 فقط بعد أن ينهي العامل الدفعة.

الاستجابة

200 OK
{
  "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