رفع ملف

نظرة عامةCopy Anchor Link

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

أوضاع الملفات المدعومةCopy Anchor Link

يتعامل TokenLab مع /v1/files كثلاثة أوضاع صريحة:

• ملفات الدفعات: استخدم purpose=batch مع /v1/batches.
• ملفات الصور/المراجع: استخدم purpose=user_data أو purpose=vision لطلبات الصور المعتمدة على الملفات.
• وضع Anthropic Files API: أضف anthropic-beta: files-api-2025-04-14 لتخزين الملفات الأصلي في Anthropic.

ملاحظاتCopy Anchor Link

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

curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

الطلب / الاستجابةCopy Anchor Link

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

نصائح تشغيليةCopy Anchor Link

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

مدخلات ملفات الصورCopy Anchor Link

يمكن لنفس مسار /v1/files تحميل ملفات صور مرجعية لاستخدامها مع /v1/images/edits.

• استخدم purpose=user_data أو purpose=vision.
• يمكنك اختيارياً تمرير model لاختيار نموذج تحرير الصور؛ القيمة الافتراضية هي gpt-image-2.
• يتم ربط file_id المُعاد بإعداد تحرير الصور المختار، ويمكن إعادة استخدامه في images[].file_id.

وضع Anthropic Files APICopy Anchor Link

يدعم هذا المسار نفسه /v1/files أيضًا مسار Anthropic Files API.

• أضف ترويسة anthropic-beta: files-api-2025-04-14 للتبديل إلى وضع Anthropic.
• في وضع Anthropic، ارفع الملف الأصلي مباشرة ولا ترسل purpose=batch.
• سيتم ربط file_id المُعاد بمساحة العمل نفسها المتوافقة مع Anthropic ويجب إعادة استخدامه في طلبات /v1/messages.
• إذا كنت تنوي الإشارة إلى هذا الملف داخل محتوى رسالة Anthropic، فاستمر في استخدام الترويسات الأصلية لـ Anthropic (x-api-key وanthropic-version وترويسة beta عند الحاجة).

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

حقول مهمةCopy Anchor Link