Փաթեթային API-ի ՀՏՀ

Ինչպե՞ս է աշխատում Batch API-ն։

Batch API-ի վերջնակետը, ինչպես փաստաթղթավորված է այստեղ, օգտատերերին թույլ է տալիս հարցումներ ուղարկել ասինխրոն փաթեթային մշակման համար։ Մենք կմշակենք այս հարցումները 24 ժամվա ընթացքում։ Յուրաքանչյուր հարցման մանրամասները կկարդացվեն նախապես վերբեռնված ֆայլից, իսկ պատասխանները կգրվեն ելքային ֆայլում։ Դուք կարող եք հարցում կատարել փաթեթային օբյեկտին՝ կարգավիճակի թարմացումներ և արդյունքներ ստանալու համար։

Որքա՞ն է Batch API-ի գինը։

Յուրաքանչյուր մոդել կառաջարկվի 50% արժեքային զեղչով՝ համեմատած սինխրոն API-ների հետ։ Մեր 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-ով սահմանված ժամանակահատվածում), մնացած աշխատանքը կչեղարկվի, իսկ արդեն կատարված աշխատանքի արդյունքները կվերադարձվեն։ Մշակողներից գումար կգանձվի կատարված ամբողջ աշխատանքի դիմաց։

Ի՞նչ կարգավիճակներ կարող եմ ակնկալել փաթեթային առաջադրանքների համար։

Փաթեթային առաջադրանքը կարող է ունենալ հետևյալ կարգավիճակներից որևէ մեկը՝ Validating, Failed, In Progress, Finalizing, Completed, Expired, Cancelling և Cancelled։ Եթե API-ի կարգավիճակի արժեքները ստուգում եք ծրագրային եղանակով, օգտագործեք փոքրատառ լիտերալները՝ validating, failed, in_progress, finalizing, completed, expired, cancelling և cancelled։

• Validating: Վերբեռնված ֆայլի վավերացումն ընթացքի մեջ է՝ նախքան փաթեթի մեկնարկը։

• Failed: Ֆայլը չի անցել վավերացման գործընթացը։

• In Progress: Ֆայլը հաջողությամբ վավերացվել է, և փաթեթային գործընթացն ընթացքի մեջ է։

• Finalizing: Փաթեթային առաջադրանքն ավարտվել է, և արդյունքները պատրաստվում են։

• Completed: Փաթեթային առաջադրանքն ավարտված է, և արդյունքները պատրաստ են։

• Expired: Փաթեթը չհաջողվեց ավարտել SLA-ի ժամանակային պատուհանի ընթացքում։

• Cancelling: Փաթեթային առաջադրանքի չեղարկումը նախաձեռնվել է։

• Cancelled: Փաթեթային առաջադրանքը չեղարկվել է։

Ինչպե՞ս կարող եմ ստուգել, թե որ փաթեթային առաջադրանքներն եմ արդեն ստեղծել։

Ձեր բոլոր փաթեթային առաջադրանքների ցանկը կարող եք ստանալ՝ օգտագործելով այստեղ նշված API կանչը։

Այս վերջնակետում աջակցվո՞ւմ է ոչ մի պահվող տվյալ ռեժիմը։

Եթե ձեր կազմակերպության համար միացված է ոչ մի պահվող տվյալ ռեժիմը, նկատի ունեցեք, որ ոչ մի պահվող տվյալը չի կիրառվում Batch API-ի նկատմամբ։ ZDR կազմակերպությունները կարող են ստեղծել փաթեթային առաջադրանքներ, սակայն փաթեթային մուտքային ֆայլերը, ելքերը, սխալները և միջանկյալ արտեֆակտները պահվում են՝ ըստ կազմաձևված Batch, File Service և Sediment պահպանման քաղաքականությունների։