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

وضعیت یک کار دسته‌ای

وضعیت، شمار سطرها، اعتبار و شناسه‌ی فایل‌های نتیجه‌ی یک کار دسته‌ای را بخوانید.

GET/v1/batches/{id}

این مسیر فقط وضعیت را می‌خواند و کاری را جلو نمی‌برد؛ هر چند دقیقه یک‌بار پرسیدن کافی است.

statusمعنی
validatingکار در حال فرستاده شدن برای اجراست
in_progressدر حال اجرا
completedتمام شده؛ output_file_id و در صورت وجود error_file_id آماده‌اند
failedاجرا نشد؛ علت در errors است و برای بخشی که تمام نشده اعتباری گرفته نمی‌شود
expiredتا موعد کار تمام نشد؛ آنچه تمام نشده هزینه‌ای ندارد

request_counts شمار کل سطرها، سطرهای موفق و سطرهای ناموفق را می‌دهد. سطرهای ناموفق در error_file_id هستند و هزینه‌ای ندارند. نتیجه‌ها را با محتوای فایل بگیرید.

نمونه‌ها

curl https://1ai.ir/v1/batches/bat_4YcMq8TzWn2KxRd6HvBjLe \
  -H "Authorization: Bearer $ONEAI_API_KEY"
200پاسخ
{
  "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
}