> ## 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 من TokenLab. تستخدم مهام الدفعة ملفات JSONL المرفوعة، وتعمل بشكل غير متزامن، ويمكن أن تعيد ملفات الإخراج/الخطأ لاحقًا.

## ملاحظات

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

## مثال

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.tokenlab.sh/v1/batches/batch_abc123/cancel" \
    -H "Authorization: Bearer sk-your-api-key"
  ```
</RequestExample>

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

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

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

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

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

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "batch_abc123",
    "object": "batch",
    "status": "cancelling",
    "input_file_id": "file_abc123"
  }
  ```
</ResponseExample>

## حقول مهمة

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