الانتقال إلى المحتوى الرئيسي
ارفع ملف إدخال دفعة بوصفه نموذجًا متعدد الأجزاء، واحتفظ بقيمة id التي يعيدها، ثم اقرأ البيانات الوصفية للملف وبايتاته بذلك المعرّف. تستخدم الأمثلة client مُنشأً كما في التثبيت.

رفع ملف

ترفع TypeScript وPython الملف باستخدام دالة في حزمة SDK، وهي ترسل POST /v1/batches/files. لا تستطيع حزم SDK الأخرى إرسال بيانات متعددة الأجزاء، لذا ترسل النموذج إلى POST /v1/files باستخدام عميل HTTP القياسي.

خيارات الرفع

تنطبق هذه الخيارات على دالتي الرفع في TypeScript وPython. في طلبات multipart المباشرة، أرسل purpose وfile بوصفهما حقلي نموذج.

قراءة ملف مجددًا

استبدل file_123 بالمعرّف الذي أعادته عملية الرفع. في Python يمكنك أيضًا الوصول إلى هذه العمليات عبر client.files: تُرفع create(params) الملف مثل upload_file، وتسرد list() الملفات، وتقرأ retrieve(id) البيانات الوصفية، وتقرأ content(id) البايتات. لا تتضمن Rust دوال للملفات.
نقاط نهاية الملفات في مرحلة تجريبية (Beta) وتتطلب تفعيل مزوّد للدفعات.

احتفظ بمعرّف الملف: لا يمكنك سرد الملفات

احفظ قيمة id لكل ملف مرفوع. تستدعي دوال السرد GET /v1/files، الذي يعيد 400 مع الرمز not_supported والسبب file_list_not_supported_with_shared_gateway_key. العقد الكامل موجود في مرجع Files API.

الاستجابة

FileObject، من دالة الرفع ودوال البيانات الوصفية:
آخر تعديل في ٥ نوفمبر ٢٠٢٦