الملفات والدفعات

عرض قائمة الملفات

عرض ملفات batch وملفات مراجع الصور المرفوعة.

GET
/v1/files

عرض قائمة بملفات batch ومراجع الصور. التصفية باستخدام purpose=batch، أو purpose=batch_output، أو purpose=user_data، أو purpose=vision.

باستخدام ترويسات Anthropic Files، تعرض نفس الـ API الملفات بتنسيق Anthropic في Workspace الحالي.

مثال

الطلب

cURL
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 عندما تكون متاحة.

الاستجابة

200 OK
{
  "object": "list",
  "data": [{ "id": "file_abc123", "object": "file", "purpose": "batch" }],
  "first_id": "file_abc123",
  "last_id": "file_abc123",
  "has_more": false
}

الحقول المهمة

objectstring
دائماً list.
dataarray
الملفات.
has_moreboolean
تتوفر المزيد من النتائج عندما تكون قيمة has_more هي true.

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

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

limit?integer

عدد الملفات المراد إرجاعها. من 1 إلى 10,000 (الافتراضي 10,000) لملفات الدفعات والصور؛ من 1 إلى 1,000 (الافتراضي 20) في وضع Anthropic Files.

النطاق1 <= value <= 10000
after?string
after_id?string

مؤشر (cursor) Anthropic Files. إرجاع الملفات بعد معرف الملف العام هذا. يتطلب رأس Anthropic Files التجريبي ولا يمكن دمجه مع before_id.

before_id?string

مؤشر (cursor) Anthropic Files. إرجاع الملفات قبل معرف الملف العام هذا. يتطلب رأس Anthropic Files التجريبي ولا يمكن دمجه مع after_id.

scope_id?string

مؤشر نطاق Anthropic Files المحجوز. تُرجع TokenLab حالياً خطأ صريحاً غير مدعوم بدلاً من تجاهل هذه القيمة بصمت.

purpose?string

عامل تصفية اختياري لغرض الملف. تغطي batch و batch_output ملفات Batch API؛ وتغطي user_data و vision روابط ملفات الصور/المراجع في TokenLab. يتم اختيار وضع Anthropic Files API بواسطة رؤوس Anthropic بدلاً من معلمة الاستعلام هذه.

القيم المتاحة

  • "batch"
  • "batch_output"
  • "user_data"
  • "vision"

الترويسات

anthropic-beta?string

قم بتضمين files-api-2025-04-14 لاستخدام وضع Anthropic Files API.

الاستجابة

application/json

application/json