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

بارگذاری فایل

یک فایل JSONL را برای ساخت کار دسته‌ای بارگذاری کنید و شناسه‌ی آن را بگیرید. فایل تا ۲۵ مگابایت و در سهمیه‌ی حساب شما نگه‌داری می‌شود.

POST/v1/files

فایل‌ها فقط برای کار دسته‌ای هستند (purpose=batch). هر سطر فایل JSONL یک درخواست گفتگو است؛ قالب سطرها در ساخت کار دسته‌ای آمده است. بارگذاری فایل را بررسی نمی‌کند: سطر نادرست هنگام ساخت کار با invalid_batch_file و شماره‌ی سطر رد می‌شود.

فایل‌ها فقط برای کاربر و فضای کاری خودتان دیده می‌شوند. هر فایل پس از مدتی حذف می‌شود (expires_at) و مجموع حجم فایل‌های هر حساب سقف دارد.

بدنه multipart/form-data است. بارگذاری هزینه‌ای ندارد.

نمونه‌ها

curl https://1ai.ir/v1/files \
  -H "Authorization: Bearer $ONEAI_API_KEY" \
  -F 'purpose=batch' \
  -F "file=@requests.jsonl"
200پاسخ
{
  "id": "fil_3vQ8mKx2Rt7LpWc9HdYnZa",
  "object": "file",
  "bytes": 1284,
  "created_at": 1793000000,
  "expires_at": 1795592000,
  "filename": "requests.jsonl",
  "purpose": "batch"
}

هدرها

  • Content-Typestringالزامی

    برای این مسیر multipart/form-data است؛ کتابخانه‌ی HTTP مرز (boundary) را خودش می‌گذارد.

بدنه‌ی درخواست

  • purposestringالزامی

    کاربرد فایل. فقط batch پذیرفته می‌شود.

    مقادیر مجاز:batch
  • filefileالزامی

    فایل JSONL، تا ۲۵ مگابایت و غیرخالی. نام فایل (تا ۲۵۵ نویسه) همان‌طور که فرستاده‌اید ذخیره می‌شود.

خطاها

  • invalid_request400

    purpose نادرست است، file نیست یا خالی است، یا بدنه‌ی multipart خراب است.

  • file_too_large413

    فایل از ۲۵ مگابایت بزرگ‌تر است.

  • file_quota_exceeded413

    حجم فایل‌های حساب با این فایل از سقف می‌گذرد. چند فایل را حذف کنید و دوباره بفرستید.

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