إنشاء دفعة (Batch)

نظرة عامةCopy Anchor Link

قم برفع ملف JSONL مع تحديد purpose=batch، ثم استخدم معرف الملف الخاص به كـ input_file_id. تُرجع الدفعات المكتملة معرفات ملفات المخرجات والأخطاء.

ملاحظاتCopy Anchor Link

• يجب أن تستخدم ملفات إدخال الدفعات purpose=batch.
• completion_window حالياً هو 24h.
• قد يختلف ترتيب المخرجات عن ترتيب المدخلات. قم بمطابقة كل نتيجة باستخدام custom_id.
• البث (Streaming) غير مدعوم داخل عناصر الدفعة.
• نقاط النهاية (endpoints) المدعومة للعناصر هي /v1/chat/completions و /v1/embeddings. أما /v1/responses فهي غير مدعومة.

مثالCopy Anchor Link

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

قد تختلف أسعار الدفعات عن الطلبات المتزامنة (synchronous requests). استخدم السعر الموضح عند إنشاء الدفعة وفي الفاتورة النهائية.

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

حقول هامةCopy Anchor Link