الملفات والدفعات
عرض قائمة الملفات
عرض ملفات batch وملفات مراجع الصور المرفوعة.
عرض قائمة بملفات batch ومراجع الصور. التصفية باستخدام 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"عوامل التصفية
- بالنسبة لملفات batch ومراجع الصور، تكون قيمة
limitبين 1–10000 (القيمة الافتراضية 10000)، مع استخدامafterللتقسيم إلى صفحات (pagination). في وضع 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 إلى 10,000 (الافتراضي 10,000) لملفات الدفعات والصور؛ من 1 إلى 1,000 (الافتراضي 20) في وضع Anthropic Files.
1 <= value <= 10000مؤشر (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