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

إنشاء دفعة

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

POST
/v1/batches

نظرة عامة

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

ملاحظات

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

مثال

الطلب

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

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

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

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

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

الاستجابة

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

حقول مهمة

idstring
معرّف لاستخدامه في الطلبات اللاحقة والدعم.
statusstring
حالة دورة الحياة الحالية لهذا المورد.
output_file_idstring|null
معرّف ملف تستخدمه APIs المرتبطة.

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json

application/json