როგორ მუშაობს Batch API?
Batch API-ის საბოლოო წერტილი, როგორც დოკუმენტირებულია აქ, მომხმარებლებს საშუალებას აძლევს, გაგზავნონ მოთხოვნები ასინქრონული პაკეტური დამუშავებისთვის. ამ მოთხოვნებს 24 საათის განმავლობაში დავამუშავებთ. თითოეული მოთხოვნის დეტალები წინასწარ ატვირთული ფაილიდან წაიკითხება, ხოლო პასუხები გამომავალ ფაილში ჩაიწერება. სტატუსის განახლებებისა და შედეგებისთვის შეგიძლიათ პაკეტის ობიექტი გამოკითხოთ.
როგორია Batch API-ის ფასები?
თითოეული მოდელი შემოთავაზებული იქნება ღირებულების 50%-იანი ფასდაკლებით სინქრონულ API-ებთან შედარებით. ჩვენი API-ის ფასების შესახებ მეტი ინფორმაცია იხილეთ აქ.
რომელი მოდელების გამოყენება შემიძლია პაკეტურად?
Batch API ფართოდ არის ხელმისაწვდომი ჩვენი მოდელების უმეტესობაში, მაგრამ არა ყველაში. გთხოვთ, გაეცნოთ მოდელების საცნობარო დოკუმენტაციას, რათა დარწმუნდეთ, რომ თქვენ მიერ გამოყენებული მოდელი მხარს უჭერს Batch API-ს.
რა მოხდება, თუ API ჩემს მოთხოვნას დაპირებულ დროში არ დაასრულებს?
ჩვენი მიზანია ყველა მოთხოვნის 24 საათში შესრულება. თუ პაკეტს ვადა გაუვა (ანუ მისი დასრულება SLA-ის დროის ფანჯარაში ვერ მოხერხდა), დარჩენილი სამუშაო გაუქმდება და უკვე შესრულებული ნებისმიერი სამუშაო დაბრუნდება. დეველოპერებს დაერიცხებათ საფასური ნებისმიერი შესრულებული სამუშაოსთვის.
რამდენი მოთხოვნის პაკეტურად გაერთიანება შემიძლია მაქსიმუმ?
Embeddings API-ებს აქვთ ერთდროულად 1 მილიონი რიგში ჩაყენებული მოთხოვნის ლიმიტი.
ყველა სხვა API-სთვის პაკეტურად გასაერთიანებელი მოთხოვნების რაოდენობაზე ლიმიტი არ არსებობს; თუმცა, გამოყენების თითოეულ დონეს აქვს შესაბამისი პაკეტური მოთხოვნების ლიმიტი. თქვენი პაკეტური მოთხოვნების ლიმიტი მოიცავს შეყვანის token-ების მაქსიმალურ რაოდენობას, რომელიც ერთდროულად გაქვთ რიგში ჩაყენებული. თქვენი მოთხოვნების ლიმიტების ნახვა შეგიძლიათ აქ.
შემიძლია შევცვალო დრო, რამდენიც 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 და cancelled.
ვალიდაცია: ატვირთული ფაილის ვალიდაცია მიმდინარეობს, სანამ პაკეტი დაიწყება.
წარუმატებელი: ფაილმა ვალიდაციის პროცესი ვერ გაიარა.
მიმდინარეობს: ფაილის ვალიდაცია წარმატებით დასრულდა და პაკეტური პროცესი მიმდინარეობს.
დასრულების ეტაპზეა: პაკეტური დავალება დასრულდა და შედეგები მზადდება.
დასრულებული: პაკეტური დავალება დასრულებულია და შედეგები მზად არის.
ვადაგასული: პაკეტის დასრულება SLA-ის დროის ფანჯარაში ვერ მოხერხდა.
გაუქმების პროცესში: პაკეტური დავალების გაუქმება ინიცირებულია.
გაუქმებული: პაკეტური დავალება გაუქმდა.
როგორ შევამოწმო, რომელი პაკეტური დავალებები მაქვს უკვე შექმნილი?
თქვენი ყველა პაკეტური დავალების სიის მიღება შეგიძლიათ აქ მითითებული API გამოძახების გამოყენებით.
ამ საბოლოო წერტილზე მონაცემთა ნულოვანი შენარჩუნება მხარდაჭერილია?
თუ თქვენს ორგანიზაციაში ჩართული გაქვთ მონაცემთა ნულოვანი შენარჩუნება, გაითვალისწინეთ, რომ მონაცემთა ნულოვანი შენარჩუნება Batch API-ზე არ ვრცელდება. ZDR ორგანიზაციებს შეუძლიათ შექმნან პაკეტური დავალებები, მაგრამ პაკეტის შეყვანის ფაილები, გამომავალი შედეგები, შეცდომები და შუალედური არტეფაქტები ინახება კონფიგურირებული Batch-ის, File Service-ისა და Sediment-ის შენარჩუნების პოლიტიკების მიხედვით.