دستهای و فایلها
وضعیت یک کار دستهای
وضعیت، شمار سطرها، اعتبار و شناسهی فایلهای نتیجهی یک کار دستهای را بخوانید.
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
}پارامترهای مسیر
idstringالزامیشناسهی کار، به شکل
bat_….
خطاها
batch_not_found404کاری با این شناسه برای حساب شما نیست.
صفحههای مرتبط
- ساخت کار دستهایفایل JSONL بارگذاریشده را به صورت یک کار غیرهمزمان اجرا کنید. اعتبار بدترین حالت همهی سطرها همینجا رزرو میشود.
- دریافت محتوای فایلمحتوای یک فایل، مثل فایل نتیجهی یک کار دستهای، را از طریق یک لینک امضاشدهی یکساعته دانلود کنید.
- لغو کار دستهایاین مسیر برای سازگاری با قالب OpenAI هست، ولی کار دستهای را لغو نمیکند و همیشه خطای 409 میدهد.