رفع ملف

أغراض الملفات (File Purposes)Copy Anchor Link

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

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

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

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

وضع واجهة برمجة تطبيقات ملفات AnthropicCopy Anchor Link

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

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

حقول هامةCopy Anchor Link