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

استرجاع الملف

يسترجع البيانات الوصفية لملف مرفوع واحد.

GET
/v1/files/{file_id}

نظرة عامة

يخدم هذا الـ endpoint أساسًا كائنات ملفات TokenLab المتوافقة مع OpenAI Batch API.

عندما يفعّل الطلب وضع التوافق مع Anthropic Files، يمكن لنفس المسار أيضًا إرجاع بيانات وصفية لملفات على نمط Anthropic مرتبطة بمساحة العمل المرتبطة.

بدون ترويسات Anthropic، يمكن لهذا المسار إرجاع كائن ملف دفعة أو كائن ملف صورة/مرجع من TokenLab.

ملاحظات

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

مثال

الطلب

cURL
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 اختياري وقد لا يظهر في عائلات ملفات لا توفره.

الاستجابة

200 OK
{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

حقول مهمة

idstring
معرّف ملف تستخدمه APIs المرتبطة.
filenamestring
اسم الملف الأصلي أو المُنشأ.
purposestring
غرض الملف الذي يستخدمه سير العمل المالك، مثل batch أو batch_output أو user_data أو vision.

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

معاملات المسار

file_id*string

الترويسات

anthropic-beta?string

قم بتضمين files-api-2025-04-14 لاستخدام وضع Anthropic Files API.

الاستجابة

application/json

application/json