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

فهرست کارهای دسته‌ای

کارهای دسته‌ای حساب را از جدید به قدیم و صفحه‌به‌صفحه بخوانید.

GET/v1/batches

جدیدترین کار اول می‌آید. برای صفحه‌ی بعد last_id را در after بفرستید و تا وقتی has_more برابر true است ادامه دهید.

نمونه‌ها

curl "https://1ai.ir/v1/batches?limit=2" \
  -H "Authorization: Bearer $ONEAI_API_KEY"
200پاسخ
{
  "object": "list",
  "data": [
    {
      "id": "bat_7Hn4WqE2yBvTxK9cJdPrMs",
      "object": "batch",
      "endpoint": "/v1/chat/completions",
      "model": "openai/gpt-5.4-mini",
      "errors": null,
      "input_file_id": "fil_3vQ8mKx2Rt7LpWc9HdYnZa",
      "completion_window": "24h",
      "status": "in_progress",
      "output_file_id": null,
      "error_file_id": null,
      "created_at": 1793000100,
      "expires_at": 1793346500,
      "completed_at": null,
      "failed_at": null,
      "expired_at": null,
      "request_counts": {
        "total": 2,
        "completed": 0,
        "failed": 0
      },
      "metadata": null,
      "estimated_credits": 1.2,
      "credits": 0
    },
    {
      "id": "bat_4YcMq8TzWn2KxRd6HvBjLe",
      "object": "batch",
      "endpoint": "/v1/chat/completions",
      "model": "openai/gpt-5.4-mini",
      "errors": null,
      "input_file_id": "fil_9TwB4cNxJ2sKd7YhVqRmEp",
      "completion_window": "24h",
      "status": "completed",
      "output_file_id": "fil_8NwQ5rTcKx3JmBd2YvHzLs",
      "error_file_id": null,
      "created_at": 1792900100,
      "expires_at": 1793246500,
      "completed_at": 1792903700,
      "failed_at": null,
      "expired_at": null,
      "request_counts": {
        "total": 40,
        "completed": 40,
        "failed": 0
      },
      "metadata": {
        "job": "reviews-september"
      },
      "estimated_credits": 9.6,
      "credits": 6.1
    }
  ],
  "first_id": "bat_7Hn4WqE2yBvTxK9cJdPrMs",
  "last_id": "bat_4YcMq8TzWn2KxRd6HvBjLe",
  "has_more": false
}

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

  • limitintegerپیش‌فرض: 20

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

  • afterstring

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

خطاها

  • invalid_request400

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

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