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

سرد الملفات

سرد ملفات الدفعات (batch) وملفات المراجع الصورية (image-reference) التي تم رفعها.

GET
/v1/files

سرد ملفات الدفعات وملفات المراجع الصورية. يمكنك التصفية باستخدام 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"

الفلاتر

  • بالنسبة لملفات الدفعات والمراجع الصورية، تتراوح قيمة 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 عند توفرها.

الاستجابة

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 <= value <= 1000
الافتراضي20
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