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

استرجاع ملف

استرجاع البيانات الوصفية لملف واحد تم رفعه.

GET
/v1/files/{file_id}

إرجاع اسم الملف، وحجمه، والغرض منه، ووقت إنشائه. بدون ترويسات Anthropic، يغطي هذا ملفات الدفعات (batch) وملفات المراجع الصورية. ومع ترويسات Anthropic Files، فإنه يغطي الملفات بتنسيق Anthropic.

مثال

الطلب

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
  -H "Authorization: Bearer sk-your-api-key"

ملفات المراجع الصورية

يمكن لهذا الـ endpoint أيضاً إرجاع البيانات الوصفية لملفات المراجع الصورية التي تم إنشاؤها بواسطة TokenLab. حقل status اختياري وقد يكون غائباً في عائلات الملفات التي لا توفر حالة.

الاستجابة

200 OK
{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

حقول هامة

idstring
معرف الملف (File ID).
filenamestring
اسم الملف الأصلي أو الذي تم إنشاؤه.
purposestring
الغرض من الملف، مثل batch أو batch_output أو user_data أو vision.

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

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

file_id*string

الترويسات

anthropic-beta?string

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

الاستجابة

application/json

application/json