دسته‌ای و فایل‌ها

دریافت محتوای فایل

محتوای یک فایل، مثل فایل نتیجه‌ی یک کار دسته‌ای، را از طریق یک لینک امضا‌شده‌ی یک‌ساعته دانلود کنید.

GET/v1/files/{id}/content

این مسیر خود فایل را برنمی‌گرداند، با 302 به یک لینک امضا‌شده هدایت می‌کند که یک ساعت اعتبار دارد و برای دانلود به کلید شما نیاز ندارد. کتابخانه‌های HTTP و SDK‌ها ریدایرکت را خودکار دنبال می‌کنند؛ در curl گزینه‌ی -L را بگذارید.

برای نتیجه‌ی یک کار، output_file_id و error_file_id همان کار را بدهید. هر سطر خروجی یک شیء JSON است:

json
{"id": "batch_req_…", "custom_id": "q-1", "response": {"status_code": 200, "request_id": "…", "body": {"object": "chat.completion"}}, "error": null}

در سطر موفق response پر و error برابر null است. در سطر ناموفق response برابر null و error برابر { "code": "request_failed", "message": … } است و برای آن هزینه‌ای گرفته نمی‌شود. نتیجه را با custom_id خودتان به رکوردها وصل کنید، نه با ترتیب سطرها.

نمونه‌ها

curl https://1ai.ir/v1/files/fil_8NwQ5rTcKx3JmBd2YvHzLs/content \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  --output output.jsonl
302پاسخ

فایل JSONL پس از ریدایرکت 302 به لینک امضا‌شده دانلود می‌شود.

پارامترهای مسیر

  • idstringالزامی

    شناسه‌ی فایل، به شکل fil_….

پارامترهای کوئری

  • redirectstring

    با مقدار false به‌جای ریدایرکت ۳۰۲، پاسخ JSON با فیلدهای url و mime و expires_in برمی‌گردد. این حالت برای برنامه‌های مرورگری است که نمی‌توانند ریدایرکت را با کلید دنبال کنند.

    مقادیر مجاز:false

خطاها

  • file_not_found404

    فایلی با این شناسه برای حساب شما نیست، یا حذف شده است.

صفحه‌های مرتبط