Batch API хэрхэн ажилладаг вэ?
Энд баримтжуулсанчлан Batch API эцсийн цэг нь хэрэглэгчдэд асинхрон багц боловсруулалтад хүсэлт илгээх боломж олгодог. Бид эдгээр хүсэлтийг 24 цагийн дотор боловсруулна. Хүсэлт бүрийн дэлгэрэнгүйг урьдчилан байршуулсан файлаас уншиж, хариуг гаралтын файлд бичнэ. Та төлөвийн шинэчлэлт болон үр дүнг авахын тулд batch объектод асуулга хийх боломжтой.
Batch API-ийн үнэ ямар вэ?
Загвар бүрийг синхрон API-уудтай харьцуулахад зардлын 50% хөнгөлөлттэй санал болгоно. Манай API-ийн үнийн талаарх нэмэлт мэдээлэл энд байна.
Би ямар загваруудыг багцалж болох вэ?
Batch API нь манай ихэнх загварт өргөнөөр ашиглах боломжтой боловч бүгдэд нь биш. Таны ашиглаж буй загвар Batch API-г дэмждэг эсэхийг баталгаажуулахын тулд загварын лавлах баримт бичиг-ийг үзнэ үү.
API миний хүсэлтийг амласан хугацаанд боловсруулж дуусгахгүй бол юу болох вэ?
Бид бүх хүсэлтийг 24 цагийн дотор боловсруулж дуусгахыг зорьдог. Багцын хугацаа дуусвал (өөрөөр хэлбэл SLA-д заасан хугацаанд боловсруулж дуусгаж чадаагүй бол) үлдсэн ажлыг цуцалж, аль хэдийн гүйцэтгэсэн ажлын үр дүнг буцаана. Гүйцэтгэж дууссан бүх ажлын төлбөрийг хөгжүүлэгчдээс авна.
Би хэдэн хүсэлтийг багцалж болох дээд хязгаар хэд вэ?
Embeddings API-ууд нэг дор дараалалд оруулсан 1 сая хүсэлтийн хязгаартай.
Бусад бүх API-ийн хувьд багцалж болох хүсэлтийн тоонд хязгаар байхгүй; гэхдээ ашиглалтын түвшин бүр холбогдох багцын хурдны хязгаартай. Таны багцын хурдны хязгаарт нэг дор дараалалд оруулсан оролтын токенуудын дээд тоо багтана. Та хурдны хязгааруудаа эндээс олох боломжтой.
Batch API-ээс хариу авахад шаардагдах хугацааг би өөрчилж болох уу?
Одоогоор бидний заасан хугацааны цонх 24 цаг байна. Бид одоогоор энэ хугацааг өөрчлөх боломжгүй.
Batch API дээр стриминг дэмжигддэг үү?
Үгүй, Batch API дээр стриминг дэмжигддэггүй. Багц хүсэлтүүд үр дүнг стриминг хариуны оронд гаралтын файлаар буцаадаг.
Batch API дээр зураг дэмжигддэг үү?
Тийм, Batch API дээр зураг дэмжигддэг.
Надад “The URL provided for this request does not prefix-match the batch endpoint” гэсэн алдааны мессеж ирсэн. Би юу хийх ёстой вэ?
Хэрэв танд энэ алдаа гарвал таны URL Batch API эцсийн цэгт буруу форматлагдсан гэсэн үг. Та эцсийн цэгийг зөв дуудаж байгаа эсэхээ баталгаажуулахын тулд энд байгаа манай баримт бичгийг үзнэ үү.
Batch API ашиглалт миний бусад хурдны хязгаарт тооцогдох уу?
Batch API-ийн хурдны хязгаарууд одоо байгаа хязгааруудаас бүрэн тусдаа.
Багцыг цуцалбал юу болох вэ?
Багцыг гараар цуцалсан тохиолдолд аль хэдийн боловсруулж дууссан үр дүнг буцаана. Гүйцэтгэж дууссан бүх ажлын төлбөрийг хөгжүүлэгчдээс авна.
Багцын хугацаа дуусвал юу болох вэ?
Багцын хугацаа дуусвал (өөрөөр хэлбэл SLA-д заасан хугацаанд боловсруулж дуусгаж чадаагүй бол) үлдсэн ажлыг цуцалж, аль хэдийн гүйцэтгэсэн ажлын үр дүнг буцаана. Гүйцэтгэж дууссан бүх ажлын төлбөрийг хөгжүүлэгчдээс авна.
Багц ажлуудад ямар төлөвүүд гарч болох вэ?
Багц ажил дараах төлөвүүдийн аль нэгтэй байж болно: Баталгаажуулж байна, Амжилтгүй, Явагдаж байна, Эцэслэж байна, Дууссан, Хугацаа дууссан, Цуцалж байна, Цуцлагдсан. Хэрэв та API төлөвийн утгуудыг програмаар шалгаж байгаа бол жижиг үсгийн литералуудыг ашиглана уу: validating, failed, in_progress, finalizing, completed, expired, cancelling, and cancelled.
Баталгаажуулж байна: Багц эхлэхээс өмнө байршуулсан файлын баталгаажуулалт явагдаж байна.
Амжилтгүй: Файл баталгаажуулалтын процессыг давж чадсангүй.
Явагдаж байна: Файл амжилттай баталгаажсан бөгөөд багц процесс явагдаж байна.
Эцэслэж байна: Багц ажил дууссан бөгөөд үр дүнг бэлтгэж байна.
Дууссан: Багц ажил дуусаж, үр дүн бэлэн болсон.
Хугацаа дууссан: Багцыг SLA хугацааны цонхонд дуусгаж чадсангүй.
Цуцалж байна: Багц ажлыг цуцлах ажиллагаа эхэлсэн.
Цуцлагдсан: Багц ажил цуцлагдсан.
Би аль хэдийн үүсгэсэн багц ажлуудаа хэрхэн шалгах вэ?
Та энд заасан API дуудлагыг ашиглан бүх багц ажлынхаа жагсаалтыг авах боломжтой.
Энэ эцсийн цэг дээр тэг өгөгдөл хадгалалт дэмжигддэг үү?
Хэрэв танай байгууллагад тэг өгөгдөл хадгалалт идэвхжсэн бол тэг өгөгдөл хадгалалт Batch API-д хамаарахгүйг анхаарна уу. ZDR байгууллагууд багц ажил үүсгэж болно, гэхдээ багцын оролтын файлууд, гаралтууд, алдаанууд болон завсрын артефактуудыг тохируулсан Batch, File Service, Sediment хадгалалтын бодлогын дагуу хадгална.