الملفات والدفعات
استرجاع الملف
يسترجع البيانات الوصفية لملف مرفوع واحد.
نظرة عامة
يخدم هذا الـ endpoint أساسًا كائنات ملفات TokenLab المتوافقة مع OpenAI Batch API.
عندما يفعّل الطلب وضع التوافق مع Anthropic Files، يمكن لنفس المسار أيضًا إرجاع بيانات وصفية لملفات على نمط Anthropic مرتبطة بمساحة العمل المرتبطة.
بدون ترويسات Anthropic، يمكن لهذا المسار إرجاع كائن ملف دفعة أو كائن ملف صورة/مرجع من TokenLab.
ملاحظات
- يجب أن تستخدم ملفات إدخال الدفعات
purpose=batch. completion_windowحاليًا24h.- ترتيب الإخراج غير مضمون؛ طابِق دائمًا بواسطة
custom_id. - لا يتم دعم البث داخل عناصر الدفعة.
الطلب
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
-H "Authorization: Bearer sk-your-api-key"الطلب / الاستجابة
استخدم لوحة OpenAPI التفاعلية أعلاه للحصول على المخطط الدقيق.
نصائح تشغيلية
- استخدم
custom_idللتسوية اللاحقة غير المتكررة. - توقع
output_file_idوerror_file_idفقط بعد أن ينهي العامل الدفعة.
ملفات مراجع الصور
يمكن لهذا الطرف أيضًا إرجاع بيانات وصفية لملفات مراجع الصور التي أنشأها TokenLab. حقل status اختياري وقد لا يظهر في عائلات ملفات لا توفره.
الاستجابة
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}حقول مهمة
batch أو batch_output أو user_data أو vision.التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
الترويسات
قم بتضمين files-api-2025-04-14 لاستخدام وضع Anthropic Files API.
الاستجابة
application/json
application/json