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

قائمة الدفعات

يستعرض مهام الدفعات لمنظمة مفتاح API الحالية.

GET
/v1/batches

نظرة عامة

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

ملاحظات

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

مثال

الطلب

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

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

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

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

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

الاستجابة

200 OK
{
  "object": "list",
  "data": [{ "id": "batch_abc123", "object": "batch", "status": "completed" }],
  "first_id": "batch_abc123",
  "last_id": "batch_abc123",
  "has_more": false
}

حقول مهمة

objectstring
نوع كائن الاستجابة.
dataarray
القائمة أو payload المعاد في هذه الاستجابة.
statusstring
حالة دورة الحياة الحالية لهذا المورد.
has_moreboolean
تتوفر نتائج إضافية عندما تكون قيمة has_more هي true.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

معاملات الاستعلام

limit?integer
النطاق1 <= value <= 100
after?string

الاستجابة

application/json

application/json