الملفات والدفعات
سرد الملفات
سرد ملفات الدفعات (batch) وملفات المراجع الصورية (image-reference) التي تم رفعها.
سرد ملفات الدفعات وملفات المراجع الصورية. يمكنك التصفية باستخدام purpose=batch أو purpose=batch_output أو purpose=user_data أو purpose=vision.
باستخدام ترويسات Anthropic Files، تقوم نفس الـ API بسرد الملفات بتنسيق Anthropic في مساحة العمل (Workspace) الحالية.
الطلب
curl -X GET "https://api.tokenlab.sh/v1/files?purpose=batch&limit=20" \
-H "Authorization: Bearer sk-your-api-key"الفلاتر
- بالنسبة لملفات الدفعات والمراجع الصورية، تتراوح قيمة
limitبين 1 و10000 (القيمة الافتراضية هي 10000)، مع استخدامafterللترقيم. في وضع Anthropic Files، تتراوح قيمةlimitبين 1 و1000 (القيمة الافتراضية هي 20)؛ استخدم إماafter_idأوbefore_id، وليس كلاهما. - يمكن أن تكون قيمة
purposeهيbatchأوbatch_outputأوuser_dataأوvision. - تُرجع
user_dataوvisionملفات المراجع الصورية التي تم إنشاؤها بواسطة TokenLab عند توفرها.
الاستجابة
{
"object": "list",
"data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
"first_id": "file_abc123",
"last_id": "file_abc123",
"has_more": false
}حقول هامة
list.has_more هي true.التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات الاستعلام
1 <= value <= 100020مؤشر (cursor) Anthropic Files. إرجاع الملفات بعد معرف الملف العام هذا. يتطلب رأس Anthropic Files التجريبي ولا يمكن دمجه مع before_id.
مؤشر (cursor) Anthropic Files. إرجاع الملفات قبل معرف الملف العام هذا. يتطلب رأس Anthropic Files التجريبي ولا يمكن دمجه مع after_id.
مؤشر نطاق Anthropic Files المحجوز. تُرجع TokenLab حالياً خطأ صريحاً غير مدعوم بدلاً من تجاهل هذه القيمة بصمت.
عامل تصفية اختياري لغرض الملف. تغطي batch و batch_output ملفات Batch API؛ وتغطي user_data و vision روابط ملفات الصور/المراجع في TokenLab. يتم اختيار وضع Anthropic Files API بواسطة رؤوس Anthropic بدلاً من معلمة الاستعلام هذه.
القيم المتاحة
- "batch"
- "batch_output"
- "user_data"
- "vision"
الترويسات
قم بتضمين files-api-2025-04-14 لاستخدام وضع Anthropic Files API.
الاستجابة
application/json
application/json