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

فهرست فایل‌ها

فایل‌های بارگذاری‌شده‌ی حساب را از جدید به قدیم و صفحه‌به‌صفحه بخوانید.

GET/v1/files

فقط فایل‌های حذف‌نشده‌ی کاربر یا فضای کاری شما برمی‌گردد، جدیدترین اول. برای صفحه‌ی بعد، last_id پاسخ را به عنوان after بفرستید و تا وقتی has_more برابر true است ادامه دهید.

نمونه‌ها

curl "https://1ai.ir/v1/files?limit=2" \
  -H "Authorization: Bearer $ONEAI_API_KEY"
200پاسخ
{
  "object": "list",
  "data": [
    {
      "id": "fil_3vQ8mKx2Rt7LpWc9HdYnZa",
      "object": "file",
      "bytes": 1284,
      "created_at": 1793000000,
      "expires_at": 1795592000,
      "filename": "requests.jsonl",
      "purpose": "batch"
    },
    {
      "id": "fil_9TwB4cNxJ2sKd7YhVqRmEp",
      "object": "file",
      "bytes": 5120,
      "created_at": 1792900000,
      "expires_at": 1795492000,
      "filename": "reviews-october.jsonl",
      "purpose": "batch"
    }
  ],
  "first_id": "fil_3vQ8mKx2Rt7LpWc9HdYnZa",
  "last_id": "fil_9TwB4cNxJ2sKd7YhVqRmEp",
  "has_more": true
}

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

  • limitintegerپیش‌فرض: 20

    تعداد فایل در هر صفحه، از ۱ تا ۱۰۰.

  • afterstring

    شناسه‌ی آخرین فایل صفحه‌ی قبل (last_id)؛ فایل‌های قدیمی‌تر از آن برمی‌گردد.

خطاها

  • invalid_request400

    limit بیرون از ۱ تا ۱۰۰ است یا after شناسه‌ی معتبر نیست.

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