Skip to main content
POST
رفع ملف
احفظ file_id المُعاد واستخدمه مجددًا مع:
  • POST /v1/batches
  • GET /v1/files/{file_id}
  • GET /v1/files/{file_id}/content
لا يتوفر GET /v1/files حاليًا باستخدام مفتاح البوابة المشترك، لذا تُعد استجابة التحميل المرجع الأساسي للحصول على معرّف الملف.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

الترويسات

x-ai-stats-provider
string

بديل في الترويسة لمعلمة الاستعلام provider.

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

model
string

معرّف النموذج المستخدم لاستنتاج مزوّد ملف الدفعة الأعلى. معرّف النموذج. وهو نص يُحدد وقت التشغيل، لذا يمكن استخدام النماذج الجديدة دون انتظار تحديث SDK.

مثال:

"ai21/jamba-1.5-large"

provider
enum<string>

تجاوز متقدم للمزوّد عند رفع الملف إلى المزوّد الأعلى.

الخيارات المتاحة:
openai,
groq,
together,
mistral

الجسم

multipart/form-data
file
file
مطلوب
purpose
string
مطلوب

الاستجابة

البيانات الوصفية للملف المرفوع

id
string
object
string
bytes
integer
created_at
integer
filename
string
purpose
string
status
string
status_details
object
آخر تعديل في ٢ أكتوبر ٢٠٢٦