Gemini 3.1 Pro Preview — бағдарламалық инженерияны, алгоритм әзірлеуді немесе мультимодалды дәлелдерді біріктіруді қажет ететін күрделі тапсырмаларға арналған Google компаниясының пайымдауға бағытталған мәтін моделі. Ол Gemini 3 Pro негізінде жасалып, құралды дәл қолдануға, тиімдірек пайымдауға және сенімді көпқадамды орындауға басымдық береді. Мәтін, кескін, аудио, бейне және PDF жазбаша жауапқа, код артефактіне немесе құрылымдалған нәтижеге үлес қоса алады.
Күрделі кодтау тапсырмасына мақсатты, репозиторийдің тиісті материалын, байқалған мінез-құлықты және сақталатын шектеулерді беріңіз. Толық код репозиторийлері тапсырмаға контекст бере алады. Код келісімін тексергенде модельден екі модульдің ортақ дерек келісімін өңдеуін салыстырып, сәйкессіздікті анықтауды және растайтын код сілтемелері бар нысаналы түзету ұсынуды сұраңыз. Пайдалы шығыс талдауды, ұсынылған түзетуді және дәлелді жалғанған қолданба орындаған тексеруден ажыратады.
Іске қосу материалдары мәтіндік тапсырмадан анимациялық SVG шығысын қоса, кодқа негізделген көрнекі түсіндірмелер мен интерактив жобаларды көрсетеді. Бұлар растрлық кескін генерациясы емес, код артефактілері. Айқын тапсырма нені түсіндіру керегін, көрнекіліктің қалай әрекет етуін және қандай деректі көрсетуін анықтай алады. Шыққан код пен көрсетілімді сол талаптармен тексеріңіз. Деректі біріктіру тапсырмасына нақты дереккөздерді беріп, ондағы қатынастар мен ескертпелерді сақтайтын бір көрініс сұраңыз.
Құжатталған ойлау деңгейлері — low, medium және high; 3.1 Pro Preview әдепкісі — high. Осы Pro профилінде ойлауды толық өшіру мүмкін емес. Шектеулі жауапқа пайымдау тереңдігінің төменірек деңгейін, қиын көпқадамды жұмысқа көбірек пайымдауды таңдаңыз, сонымен бірге соңғы артефактқа жеткілікті шығыс көлемін қалдырыңыз. Шағын шығыс шегі жарамды соңғы жауап пайда болмай тұрып пайымдауды үзуі мүмкін. Ойлау нұсқаулығы пайымдау түйіндемесін толық ішкі үдерістен ажыратып, диалогтың ойлау қолтаңбасы контекстінің маңызын түсіндіреді.
Дәл Preview кестесінде функция шақыру, код орындау, іздеу арқылы негіздеу, Maps арқылы негіздеу, URL контексті және құрылымдалған шығыс көрсетілген. File Search AI Studio аясымен шектелген. Функция мақсаттары мен параметр анықтамаларын беріп, нақты қайтарылған нәтижеден жалғастырыңыз. Бөлек Custom Tools Preview профилі арнайы құралдар мен bash-қа басымдық беруге оңтайланған; ол өндірушінің жеке атаулы түпкі нүктесі, сондықтан бұл мамандануды әр 3.1 Pro сұрауының қасиеті ретінде үнсіз қабылдауға болмайды. Тапсырмаға еркін прозаның орнына анықталған жазбалар қажет болса, құрылымдалған нәтиже схемасын таңдаңыз.
Мультимодаль талдауда тиісті бетті, көрнекілікті, жазба аралығын немесе бейне оқиғасын көрсетіңіз. Құжат талдауында диаграмманы жазбаша спецификациясымен салыстырып, әр алшақтықты растайтын үзіндісімен қайтарыңыз. Ауызша дереккөз мәтіндік транскрипт не түсіндіру бере алады. Тексеруді қажет ететін қорытындыларға дереккөз сілтемелерін сақтап, көрінетін не айтылған нәрсені тұжырымдалған нәрседен ажыратыңыз. Бұл профильдің шығысы кодты қоса мәтін болып қалады; төл кескін не сөйлеу генерациясы дәл мүмкіндіктер кестесіне кірмейді.
Төл 3.1 Pro картасы 1M-ге дейін контекст пен 64K мәтін шығысын, дәл Preview API кестесі 1,048,576 кіріс және 65,536 шығыс токенін көрсетеді. Кіріс бюджетіне нұсқауларды, диалог тарихын және медианы қосыңыз. Кэштеу мен пакеттік өңдеу құжатталған; өндіруші профилінде Flex пен Priority таңдаулары да бар. Бірнеше тәуелсіз элемент үшін қажетті шығысты анықтап, байланыссыз дәлелдерді ізі табылмайтын бір жауапқа біріктірмей, әр дереккөз идентификаторын сақтаңыз.
Атаулы Preview нұсқасы Pro моделінің Custom Tools профилінен және кейінгі Flash не Pro шығарылымдарынан бөлек болып қалады. Оның күшті жақтары күрделі пайымдауға, кодтауға және дәлелдерді біріктіруге қатысты; соңғы артефактты бәрібір дереккөзбен және нақты құрал нәтижелерімен тексеру керек. Берілген ақпарат анық қорытындыны қолдамаса, шешілмеген екіұштылықты сақтаңыз. Пайдалы нәтиже — іс жүзіндегі шектерін бағалауға жеткілікті дәлелі бар, тапсырма сұраған негізделген жауап, код немесе жазба.
", "aboutText": "Gemini 3.1 Pro Preview — бағдарламалық инженерияны, алгоритм әзірлеуді немесе мультимодалды дәлелдерді біріктіруді қажет ететін күрделі тапсырмаларға арналған Google компаниясының пайымдауға бағытталған мәтін моделі. Ол Gemini 3 Pro негізінде жасалып, құралды дәл қолдануға, тиімдірек пайымдауға және сенімді көпқадамды орындауға басымдық береді. Мәтін, кескін, аудио, бейне және PDF жазбаша жауапқа, код артефактіне немесе құрылымдалған нәтижеге үлес қоса алады.\n\nКүрделі кодтау тапсырмасына мақсатты, репозиторийдің тиісті материалын, байқалған мінез-құлықты және сақталатын шектеулерді беріңіз. Толық код репозиторийлері тапсырмаға контекст бере алады. Код келісімін тексергенде модельден екі модульдің ортақ дерек келісімін өңдеуін салыстырып, сәйкессіздікті анықтауды және растайтын код сілтемелері бар нысаналы түзету ұсынуды сұраңыз. Пайдалы шығыс талдауды, ұсынылған түзетуді және дәлелді жалғанған қолданба орындаған тексеруден ажыратады.\n\nІске қосу материалдары мәтіндік тапсырмадан анимациялық SVG шығысын қоса, кодқа негізделген көрнекі түсіндірмелер мен интерактив жобаларды көрсетеді. Бұлар растрлық кескін генерациясы емес, код артефактілері. Айқын тапсырма нені түсіндіру керегін, көрнекіліктің қалай әрекет етуін және қандай деректі көрсетуін анықтай алады. Шыққан код пен көрсетілімді сол талаптармен тексеріңіз. Деректі біріктіру тапсырмасына нақты дереккөздерді беріп, ондағы қатынастар мен ескертпелерді сақтайтын бір көрініс сұраңыз.\n\nҚұжатталған ойлау деңгейлері — low, medium және high; 3.1 Pro Preview әдепкісі — high. Осы Pro профилінде ойлауды толық өшіру мүмкін емес. Шектеулі жауапқа пайымдау тереңдігінің төменірек деңгейін, қиын көпқадамды жұмысқа көбірек пайымдауды таңдаңыз, сонымен бірге соңғы артефактқа жеткілікті шығыс көлемін қалдырыңыз. Шағын шығыс шегі жарамды соңғы жауап пайда болмай тұрып пайымдауды үзуі мүмкін. Ойлау нұсқаулығы пайымдау түйіндемесін толық ішкі үдерістен ажыратып, диалогтың ойлау қолтаңбасы контекстінің маңызын түсіндіреді.\n\nДәл Preview кестесінде функция шақыру, код орындау, іздеу арқылы негіздеу, Maps арқылы негіздеу, URL контексті және құрылымдалған шығыс көрсетілген. File Search AI Studio аясымен шектелген. Функция мақсаттары мен параметр анықтамаларын беріп, нақты қайтарылған нәтижеден жалғастырыңыз. Бөлек Custom Tools Preview профилі арнайы құралдар мен bash-қа басымдық беруге оңтайланған; ол өндірушінің жеке атаулы түпкі нүктесі, сондықтан бұл мамандануды әр 3.1 Pro сұрауының қасиеті ретінде үнсіз қабылдауға болмайды. Тапсырмаға еркін прозаның орнына анықталған жазбалар қажет болса, құрылымдалған нәтиже схемасын таңдаңыз.\n\nМультимодаль талдауда тиісті бетті, көрнекілікті, жазба аралығын немесе бейне оқиғасын көрсетіңіз. Құжат талдауында диаграмманы жазбаша спецификациясымен салыстырып, әр алшақтықты растайтын үзіндісімен қайтарыңыз. Ауызша дереккөз мәтіндік транскрипт не түсіндіру бере алады. Тексеруді қажет ететін қорытындыларға дереккөз сілтемелерін сақтап, көрінетін не айтылған нәрсені тұжырымдалған нәрседен ажыратыңыз. Бұл профильдің шығысы кодты қоса мәтін болып қалады; төл кескін не сөйлеу генерациясы дәл мүмкіндіктер кестесіне кірмейді.\n\nТөл 3.1 Pro картасы 1M-ге дейін контекст пен 64K мәтін шығысын, дәл Preview API кестесі 1,048,576 кіріс және 65,536 шығыс токенін көрсетеді. Кіріс бюджетіне нұсқауларды, диалог тарихын және медианы қосыңыз. Кэштеу мен пакеттік өңдеу құжатталған; өндіруші профилінде Flex пен Priority таңдаулары да бар. Бірнеше тәуелсіз элемент үшін қажетті шығысты анықтап, байланыссыз дәлелдерді ізі табылмайтын бір жауапқа біріктірмей, әр дереккөз идентификаторын сақтаңыз.\n\nАтаулы Preview нұсқасы Pro моделінің Custom Tools профилінен және кейінгі Flash не Pro шығарылымдарынан бөлек болып қалады. Оның күшті жақтары күрделі пайымдауға, кодтауға және дәлелдерді біріктіруге қатысты; соңғы артефактты бәрібір дереккөзбен және нақты құрал нәтижелерімен тексеру керек. Берілген ақпарат анық қорытындыны қолдамаса, шешілмеген екіұштылықты сақтаңыз. Пайдалы нәтиже — іс жүзіндегі шектерін бағалауға жеткілікті дәлелі бар, тапсырма сұраған негізделген жауап, код немесе жазба.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "070ffa8ad130afeee059a2dc50576b41b09f63430fefda1702ecbc41ae95defe", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "kk", "methods": [ { "html": "google/gemini-3.1-pro-preview:batchGemini 3.1 Pro Preview — Google компаниясының күрделі бағдарламалық, алгоритмдік және білім тапсырмаларына арналған мультимодаль ой қорыту моделі. Ол мәтін, сурет, аудио, бейне және PDF қабылдап, құралдар мен құрылымдалған шығысты қолдай отырып мәтін не код қайтарады. low, medium және high деңгейлері ой қорыту күшін бағыттайды; құжатталған әдепкі мән — high.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Gemini 3.1 Pro Preview — бағдарламалық инженерияны, алгоритм әзірлеуді немесе мультимодалды дәлелдерді біріктіруді қажет ететін күрделі тапсырмаларға арналған Google компаниясының пайымдауға бағытталған мәтін моделі. Ол Gemini 3 Pro негізінде жасалып, құралды дәл қолдануға, тиімдірек пайымдауға және сенімді көпқадамды орындауға басымдық береді. Мәтін, кескін, аудио, бейне және PDF жазбаша жауапқа, код артефактіне немесе құрылымдалған нәтижеге үлес қоса алады.
Күрделі кодтау тапсырмасына мақсатты, репозиторийдің тиісті материалын, байқалған мінез-құлықты және сақталатын шектеулерді беріңіз. Толық код репозиторийлері тапсырмаға контекст бере алады. Код келісімін тексергенде модельден екі модульдің ортақ дерек келісімін өңдеуін салыстырып, сәйкессіздікті анықтауды және растайтын код сілтемелері бар нысаналы түзету ұсынуды сұраңыз. Пайдалы шығыс талдауды, ұсынылған түзетуді және дәлелді жалғанған қолданба орындаған тексеруден ажыратады.
Іске қосу материалдары мәтіндік тапсырмадан анимациялық SVG шығысын қоса, кодқа негізделген көрнекі түсіндірмелер мен интерактив жобаларды көрсетеді. Бұлар растрлық кескін генерациясы емес, код артефактілері. Айқын тапсырма нені түсіндіру керегін, көрнекіліктің қалай әрекет етуін және қандай деректі көрсетуін анықтай алады. Шыққан код пен көрсетілімді сол талаптармен тексеріңіз. Деректі біріктіру тапсырмасына нақты дереккөздерді беріп, ондағы қатынастар мен ескертпелерді сақтайтын бір көрініс сұраңыз.
Құжатталған ойлау деңгейлері — low, medium және high; 3.1 Pro Preview әдепкісі — high. Осы Pro профилінде ойлауды толық өшіру мүмкін емес. Шектеулі жауапқа пайымдау тереңдігінің төменірек деңгейін, қиын көпқадамды жұмысқа көбірек пайымдауды таңдаңыз, сонымен бірге соңғы артефактқа жеткілікті шығыс көлемін қалдырыңыз. Шағын шығыс шегі жарамды соңғы жауап пайда болмай тұрып пайымдауды үзуі мүмкін. Ойлау нұсқаулығы пайымдау түйіндемесін толық ішкі үдерістен ажыратып, диалогтың ойлау қолтаңбасы контекстінің маңызын түсіндіреді.
Дәл Preview кестесінде функция шақыру, код орындау, іздеу арқылы негіздеу, Maps арқылы негіздеу, URL контексті және құрылымдалған шығыс көрсетілген. File Search AI Studio аясымен шектелген. Функция мақсаттары мен параметр анықтамаларын беріп, нақты қайтарылған нәтижеден жалғастырыңыз. Бөлек Custom Tools Preview профилі арнайы құралдар мен bash-қа басымдық беруге оңтайланған; ол өндірушінің жеке атаулы түпкі нүктесі, сондықтан бұл мамандануды әр 3.1 Pro сұрауының қасиеті ретінде үнсіз қабылдауға болмайды. Тапсырмаға еркін прозаның орнына анықталған жазбалар қажет болса, құрылымдалған нәтиже схемасын таңдаңыз.
Мультимодаль талдауда тиісті бетті, көрнекілікті, жазба аралығын немесе бейне оқиғасын көрсетіңіз. Құжат талдауында диаграмманы жазбаша спецификациясымен салыстырып, әр алшақтықты растайтын үзіндісімен қайтарыңыз. Ауызша дереккөз мәтіндік транскрипт не түсіндіру бере алады. Тексеруді қажет ететін қорытындыларға дереккөз сілтемелерін сақтап, көрінетін не айтылған нәрсені тұжырымдалған нәрседен ажыратыңыз. Бұл профильдің шығысы кодты қоса мәтін болып қалады; төл кескін не сөйлеу генерациясы дәл мүмкіндіктер кестесіне кірмейді.
Төл 3.1 Pro картасы 1M-ге дейін контекст пен 64K мәтін шығысын, дәл Preview API кестесі 1,048,576 кіріс және 65,536 шығыс токенін көрсетеді. Кіріс бюджетіне нұсқауларды, диалог тарихын және медианы қосыңыз. Кэштеу мен пакеттік өңдеу құжатталған; өндіруші профилінде Flex пен Priority таңдаулары да бар. Бірнеше тәуелсіз элемент үшін қажетті шығысты анықтап, байланыссыз дәлелдерді ізі табылмайтын бір жауапқа біріктірмей, әр дереккөз идентификаторын сақтаңыз.
Атаулы Preview нұсқасы Pro моделінің Custom Tools профилінен және кейінгі Flash не Pro шығарылымдарынан бөлек болып қалады. Оның күшті жақтары күрделі пайымдауға, кодтауға және дәлелдерді біріктіруге қатысты; соңғы артефактты бәрібір дереккөзбен және нақты құрал нәтижелерімен тексеру керек. Берілген ақпарат анық қорытындыны қолдамаса, шешілмеген екіұштылықты сақтаңыз. Пайдалы нәтиже — іс жүзіндегі шектерін бағалауға жеткілікті дәлелі бар, тапсырма сұраған негізделген жауап, код немесе жазба.
POST /v1/batchestexttext| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісendpoint | Түріstring | ТалапМіндетті | Мәндер мен шектеулер /v1/chat/completions | Әдепкі— |
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер google/gemini-3.1-pro-preview:batch | Әдепкі— |
Өрісrequests | Түріbatch_item[] | ТалапМіндетті | Мәндер мен шектеулер Элементтердің ең аз саны: 1 | Әдепкі— |
Өрісrequests[].custom_id | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісrequests[].body.messages | Түріmessage[] | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісcompletion_window | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 24h | Әдепкі— |
Өрісprovider | Түріobject|null | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісrequests[].body.model | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер google/gemini-3.1-pro-preview:batch, google/gemini-3.1-pro-preview | Әдепкі— |
Өрісprovider.only | Түріstring[] | ТалапМіндетті емес | Мәндер мен шектеулер google-vertex/global | Әдепкі— |
Өрісprovider.allow_fallbacks | Түріboolean|null | ТалапМіндетті емес | Мәндер мен шектеулер false, null | Әдепкі— |
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыendpoint, model, requests |
Параметрmaterial_types | Параметр талаптарыtext |
Параметрrepresentation | Параметр талаптарыСұрау ішіне енгізілген requests[]; әр элементте custom_id және body бар |
Параметрrequest_endpoint_profile | Параметр талаптары/v1/chat/completions |
Параметрfile_material | Параметр талаптарыСұрауды жіберуші нақты UTF-8 JSONL деректерін жергілікті ортада оқып, requests[] ішіне енгізе алады. Жүктеу мақсаты, input_file_id немесе файлға сілтеме қолданылмайды. Клиент материалы жоқ немесе бос болса, дайындық POST жіберілгенге дейін тоқтатылады. |
Параметрserialization_order | Параметр талаптарыendpoint, model, provider (берілген болса), completion_window (берілген болса), requests өрісін соңында орналастырыңыз |
Параметрoptional_controls | Параметр талаптарыprovider.only, provider.allow_fallbacks, completion_window |
Параметрschema_scope | Параметр талаптарыҚұжаттамада сипатталған, сұраудың ішіне енгізілетін Batch құрылымындағы мәтіндік Chat Completions сұрауларының денелері. |
Өмірлік цикл: asynchronous
GET /v1/batches/{operation_id} · Бастапқы жасау жауабындағы нақты response.id; сол пайдаланушы/кілт/топ
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Контекст токендерінің саны мынадан көп | Контекст токендерінің саны мынадан аспайды, шегі кіреді | Төлем |
|---|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Контекст токендерінің саны мынадан көп— | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері $0.002 / 1K токен Шығыс · Шығыс токендері $0.012 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен |
| БаптауСұрау ұзындығының 1-деңгейі | Мөлшерлемелер кестесі— | Контекст токендерінің саны мынадан көп0 | Контекст токендерінің саны мынадан аспайды, шегі кіреді200 000 | Төлем Кіріс · Кіріс токендері $0.002 / 1K токен Шығыс · Шығыс токендері $0.012 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен |
| БаптауСұрау ұзындығының 2-деңгейі | Мөлшерлемелер кестесі— | Контекст токендерінің саны мынадан көп200 000 | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері $0.004 / 1K токен Шығыс · Шығыс токендері $0.018 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-3.1-pro-preview:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\nimport json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError("Customer JSONL file is missing")\n items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]\n if not items: raise ValueError("Customer JSONL contains no requests")\n ids = set()\n for item in items:\n if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")\n cid = item["custom_id"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")\n ids.add(cid)\n if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")\n supplied_model = item["body"].get("model")\n if supplied_model is not None and supplied_model not in ['google/gemini-3.1-pro-preview:batch', 'google/gemini-3.1-pro-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.1-pro-preview:batch", "requests":items}\n\nif __name__ == "__main__":\n material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")\n if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")\n body = prepare_requests(material)\n key = os.environ.get("AILOOT_API_KEY", "")\n if not key: raise SystemExit("Set AILOOT_API_KEY")\n request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")\n with urlopen(request) as response:\n raw = response.read()\n Path("batch-create-response.json").write_bytes(raw)\n print(raw.decode("utf-8"))\nimport json\nfrom pathlib import Path\nraw = Path("batch-status-response.json").read_bytes()\nresponse = json.loads(raw)\nif response.get("status") != "completed":\n raise SystemExit("Keep the original operation; read its status without resubmitting")\nresults = response.get("results")\nif not isinstance(results, list) or not results:\n raise SystemExit("Preserve the original response; completed results are missing")\nPath("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\\n" for item in results), encoding="utf-8")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\nЖауаптың ішіндегі results[].response.body JSON деректері
GET /v1/batches/{operation_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\nҚайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.
Бастапқы күй туралы толық JSON деректерін, әрбір нәтижені/custom_id мәнін және жауаптың немесе қатенің толық денесін сақтаңыз. Аяқталған results[] деректерін сүзгілемей JSONL түрінде сақтаңыз.
Бастапқы операцияның ID мәнін сақтаңыз. 503 result_pending_check жауабында X-Should-Retry:false көрсетіледі; нәтижесі белгісіз бастапқы пакетті ешқашан қайта жібермеңіз.
| Өріс | Түрі |
|---|---|
Өрісresults[].custom_id | Түріstring |
Өрісresults[].response.body.choices[].message.content | Түріstring|null |
Өрісresults[].error | Түріobject|null |
Өрісusage | Түріobject|null |
Өрісid | Түріstring |
Өрісmodel | Түріstring |
Өрісendpoint | Түріstring |
Өрісstatus | Түріstring |
Өрісrequest_counts | Түріobject |
Өрісresults[].id | Түріstring |
Өрісresults[].response.status_code | Түріinteger |
Өрісresults[].response.request_id | Түріstring |
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартҚұжаттамада сипатталған сұрау ішіндегі құрылым жарамсыз, кілттер қайталанады, элементтің сәйкестігі бұзылған немесе бапталған модель мүмкіндіктері арасында қайшылық бар. | Келесі қадамЖаңадан жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауап401 · authentication_error | ШартЖарамсыз API кілті. | Келесі қадамПайдалануға рұқсат берілген Ailoot кілтін қолданыңыз. |
Жауап403 · permission_error | ШартПакеттік өңдеу тобы қолжетімсіз. | Келесі қадамКілттің/топтың қол жеткізу құқығын тексеріңіз. |
Жауап422 · invalid_request_error | ШартBatch төлемді баланстан алады; жазылыммен төленетін жасау сұрауы қабылданбайды. | Келесі қадамБаланстан төлем алынатын, пайдалануға рұқсат берілген топты қолданыңыз. |
Жауап422 · price_unavailable | ШартBatch кіріс деректерінің құнын алдын ала есептеу мүмкін емес. | Келесі қадамЖауапты сақтаңыз; осы әдістер тобы үшін құжаттамада сипатталған кіріс деректерін қолданыңыз. |
Жауап402 · billing_error | ШартПакеттік өңдеу үшін қаражатты резервтеу қолжетімсіз. | Келесі қадамЖаңа сұрау жібермес бұрын сұрауды қабылдау мәселесін шешіңіз. |
Жауап503 · price_unavailable | ШартBatch әдісінің бағасы/жүйенің төл тарифтері қолжетімсіз. | Келесі қадамЖауапты сақтаңыз; бағаларды басқа мәндермен алмастырмаңыз. |
Жауап503 · api_error | ШартПровайдердің осы нақты маршруты қолжетімсіз. | Келесі қадамМаршрутты түзету үшін жауапты сақтаңыз. |
Жауап503 · result_pending_check | ШартБастапқы нәтижені тексеру қажет; X-Should-Retry:false. | Келесі қадамБастапқы operation_id/id мәнін сақтап, оның күйін оқыңыз; бастапқы POST сұрауын ешқашан қайталамаңыз. |
Жауап404 · not_found | ШартBatch күйін тексеретін операция жоқ немесе басқа субъектіге тиесілі. | Келесі қадамБастапқы id мәнін дәл қолданыңыз және сол пайдаланушыны/кілтті/топты пайдаланыңыз. |
Ailoot Ultra google/gemini-3.1-pro-preview:batch
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.