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

استرجاع محتوى الملف

يقوم بتنزيل المحتوى الأصلي لملف مرفوع.

GET
/v1/files/{file_id}/content

نظرة عامة

تخدم هذه النقطة بشكل أساسي استرجاع محتوى ملفات Batch المتوافقة مع OpenAI في TokenLab.

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

بدون ترويسات Anthropic، ينزل هذا المسار محتوى ملفات الدفعات أو يمرر محتوى ملف صورة/مرجع مرتبط عندما يدعم المزود استرجاع محتوى الملف.

ملاحظات

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

مثال

الطلب

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123/content" \
  -H "Authorization: Bearer sk-your-api-key" \
  --output batch-output.jsonl

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

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

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

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

أنواع المحتوى

يُعاد محتوى ملفات الدُفعات بصيغة JSONL أو نص عادي. ويمكن تمرير محتوى مراجع الصور التي أنشأها TokenLab كمحتوى ثنائي عندما يدعم موفر الملف الخلفي استرجاع المحتوى.

الاستجابة

200 OK
{"custom_id":"request-1","response":{"status_code":200,"body":{"id":"chatcmpl_abc123"}}}
{"custom_id":"request-2","error":{"code":"invalid_request_error","message":"Invalid model"}}

حقول مهمة

bodybinary|string
محتوى الملف. احفظه أو حلله وفقًا لـ Content-Type؛ وحلل JSONL سطرًا بسطر.
custom_idstring
معرّف يربط عنصر إدخال الدفعة بنتيجته.

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

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

file_id*string

الاستجابة

text/plain

application/json