إنشاء دفعة

​

نظرة عامة

​

ملاحظات

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

​

مثال

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"
  }'

​

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

​

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

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

​

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

{
  "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
}

​

حقول مهمة