> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# إنشاء دفعة

> ينشئ مهمة دفعة متوافقة مع OpenAI من ملف إدخال تم تحميله.

## نظرة عامة

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

## ملاحظات

* يجب أن تستخدم ملفات إدخال الدفعة `purpose=batch`.
* `completion_window` حاليًا `24h`.
* ترتيب الإخراج غير مضمون؛ يجب دائمًا المطابقة بواسطة `custom_id`.
* لا يتم دعم البث داخل عناصر الدفعة.
* نقاط نهاية عناصر الدفعة المدعومة حاليًا هي `/v1/chat/completions` و `/v1/embeddings`؛ يتم رفض مهام دفعة `/v1/responses` إلى أن يتوفر منفذ دفعات Responses أصلي.

## مثال

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.tokenlab.sh/v1/batches" \
    -H "Authorization: Bearer sk-your-api-key" \
    -H "Content-Type: application/json" \
    -d '{
      "input_file_id": "file_abc123",
      "endpoint": "/v1/chat/completions",
      "completion_window": "24h"
    }'
  ```
</RequestExample>

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

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

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

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

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

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "batch_abc123",
    "object": "batch",
    "endpoint": "/v1/chat/completions",
    "input_file_id": "file_abc123",
    "completion_window": "24h",
    "status": "validating",
    "output_file_id": null,
    "error_file_id": null,
    "created_at": 1706000000
  }
  ```
</ResponseExample>

## حقول مهمة

<ResponseField name="id" type="string">معرّف لاستخدامه في الطلبات اللاحقة والدعم.</ResponseField>
<ResponseField name="status" type="string">حالة دورة الحياة الحالية لهذا المورد.</ResponseField>
<ResponseField name="output_file_id" type="string|null">معرّف ملف تستخدمه APIs المرتبطة.</ResponseField>