> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# استرجاع الملف

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

## نظرة عامة

يخدم هذا الـ endpoint أساسًا كائنات ملفات TokenLab المتوافقة مع OpenAI Batch API.

عندما يفعّل الطلب وضع التوافق مع Anthropic Files، يمكن لنفس المسار أيضًا إرجاع بيانات وصفية لملفات على نمط Anthropic مرتبطة بمساحة العمل المرتبطة.

بدون ترويسات Anthropic، يمكن لهذا المسار إرجاع كائن ملف دفعة أو كائن ملف صورة/مرجع من TokenLab.

## ملاحظات

* يجب أن تستخدم ملفات إدخال الدفعات `purpose=batch`.
* `completion_window` حاليًا `24h`.
* ترتيب الإخراج غير مضمون؛ طابِق دائمًا بواسطة `custom_id`.
* لا يتم دعم البث داخل عناصر الدفعة.

## مثال

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
    -H "Authorization: Bearer sk-your-api-key"
  ```
</RequestExample>

## الطلب / الاستجابة

استخدم لوحة OpenAPI التفاعلية أعلاه للحصول على المخطط الدقيق.

## نصائح تشغيلية

* استخدم `custom_id` للتسوية اللاحقة غير المتكررة.
* توقع `output_file_id` و `error_file_id` فقط بعد أن ينهي العامل الدفعة.
* قد تختلف أسعار الدفعة عن الأسعار المتزامنة لأن قواعد خصم `isBatchRequest=true` تنطبق.

## مثال الاستجابة

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "file_abc123",
    "object": "file",
    "bytes": 32768,
    "created_at": 1706000000,
    "filename": "batch-input.jsonl",
    "purpose": "batch"
  }
  ```
</ResponseExample>

## حقول مهمة

<ResponseField name="id" type="string">معرّف ملف تستخدمه APIs المرتبطة.</ResponseField>
<ResponseField name="filename" type="string">اسم الملف الأصلي أو المُنشأ.</ResponseField>
<ResponseField name="purpose" type="string">غرض الملف الذي يستخدمه سير العمل المالك، مثل `batch` أو `batch_output` أو `user_data` أو `vision`.</ResponseField>