الملفات والدفعات
إنشاء دفعة
ينشئ مهمة دفعة متوافقة مع OpenAI من ملف إدخال تم تحميله.
نظرة عامة
تعتبر هذه النقطة جزءًا من واجهة برمجة التطبيقات للدفعات المتوافقة مع OpenAI من TokenLab. تستخدم مهام الدفعة ملفات JSONL المحملة، وتعمل بشكل غير متزامن، ويمكن أن تعيد ملفات الإخراج/الأخطاء لاحقًا.
ملاحظات
- يجب أن تستخدم ملفات إدخال الدفعة
purpose=batch. completion_windowحاليًا24h.- ترتيب الإخراج غير مضمون؛ يجب دائمًا المطابقة بواسطة
custom_id. - لا يتم دعم البث داخل عناصر الدفعة.
- نقاط النهاية المدعومة لعناصر الدفعة هي
/v1/chat/completionsو/v1/embeddings. لا تُدعم/v1/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"
}'الطلب / الاستجابة
استخدم لوحة OpenAPI التفاعلية أعلاه للحصول على المخطط الدقيق.
نصائح تشغيلية
- استخدم
custom_idللتسوية غير المتكررة في الأسفل. - توقع
output_file_idوerror_file_idفقط بعد أن ينهي العامل الدفعة.
الاستجابة
{
"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
}حقول مهمة
التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
الترويسات
سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.
القيم المتاحة
- "auto"
- "verified"
- "official"
جسم الطلب
application/json
الاستجابة
application/json
application/json
application/json
application/json
application/json