Source: https://ailoot.ai/models/kk/openai-gpt-5-image-mini/ Canonical: https://ailoot.ai/models/kk/openai-gpt-5-image-mini/ Language: kk # OpenAI: GPT-5 Image Mini [Markdown](https://ailoot.ai/models/kk/openai-gpt-5-image-mini/index.md) · [JSON](https://ailoot.ai/models/kk/openai-gpt-5-image-mini/facts.json) ## [OpenAI: GPT-5 Image Mini](https://ailoot.ai/models/kk/openai-gpt-5-image-mini/) GPT-5 Image Mini OpenAI ұсынған GPT-5 Mini тілдік мүмкіндіктерін GPT Image 1 Mini арқылы көрнекі материал жасау және үлгіге сүйеніп өңдеумен біріктіреді. Мәтін, сурет және құжаттарды қабылдап, мәтін мен суреттер қайтарады; жазбаша жауап пен көрнекі материал екеуі де қажет болатын үдерістерді қолдайды. - [**Ailoot Ultra · OpenAI чаты** `POST /v1/chat/completions` `openai/gpt-5-image-mini`](https://ailoot.ai/models/kk/openai-gpt-5-image-mini/#method-0) - [**Ailoot Ultra · Суреттер** `POST /v1/images/generations` `openai/gpt-5-image-mini`](https://ailoot.ai/models/kk/openai-gpt-5-image-mini/#method-1) - [**Ailoot Ultra · Anthropic хабарламалары** `POST /v1/messages` `openai/gpt-5-image-mini`](https://ailoot.ai/models/kk/openai-gpt-5-image-mini/#method-2) Модель туралы Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген. GPT-5 Image Mini — OpenAI ұсынған GPT-5 Mini және GPT Image 1 Mini негізіндегі біріктірілген тілдік және суреттік профиль. Тілдік құрамдасы жазбаша тапсырма мен дереккөз материалын түсіндіреді, ал суреттік құрамдасы көрнекі мазмұн жасайды немесе өңдейді. Жарияланған профиль нұсқауларды орындауға, мәтінді суретте көрсетуге және суретті егжей-тегжейлі өңдеуге мән береді. Ол жазбаша түсіндіруді, түсіндірмені немесе ілеспе мәтінді де қажет ететін нысаналы көрнекі тапсырмаға пайдалы. #### Жазбаша тапсырма мен көрнекі нәтижені біріктіру Қажетті материалды, негізгі нысанды, композицияны және міндетті мәтінді қамтитын тапсырма дайындаңыз. Суреттің қалай қолданылатынын сипаттаңыз: өнім тұжырымдамасы, қысқа түсіндірмеге ілесетін иллюстрация немесе беттің көрнекі нобайы ретінде. Тұжырымдаманың түсіндірмесін суреттің өзінен оңай ажырату үшін жазбаша және көрнекі нәтижелерді анық сұраңыз. Мысалы, қайта пайдаланылатын су бөтелкесінің сипаттамасын беріп, қысқа жазуы бар, өнімді көрсететін қарапайым көрініс тұжырымдамасын сұраңыз. Бөтелкенің көрінетін пішінін, фонды, жарық бағытын және суретте болуы тиіс нақты сөздерді көрсетіңіз. Жазуда пайдаланылатын фактілерді көріністің сәндік бөлшектерінен бөлек ұстаңыз. Қайтарылған сурет пен жазбаша мәтінді тапсырманың осы екі бөлігімен салыстырыңыз. Құжатталған біріктірілген профиль мәтінді, суреттерді және PDF сияқты файлдарды қабылдайды. Құжат көрнекі материалды жасамай тұрып түсіндіру қажет талаптар не фактілер бере алады. Сурет сыртқы көріністі, макетті немесе өңдеуге арналған бастапқы материалды бере алады. Әр тіркеме нәтиженің әр бөлігіне әсер етуі тиіс деп болжамай, әр дереккөздің рөлін көрсетіңіз. Бірнеше кіріс берілсе, дереккөздердің атаулары мен ретін анық сақтаңыз. #### Үлгілер арқылы жасау және өңдеу Жаңа сурет үшін не көрінуі және бөліктердің қалай байланысуы тиіс екенін анықтаңыз. Үлгіге негізделген өңдеу үшін өзгерісті және сақталуы тиіс бөлшектерді көрсетіңіз. Өнім көрінісі заттың танылатын пішіні мен көрінетін белгісін сақтап, жаңа орта сұрай алады. Сызба сақталуы тиіс мәтін мен элементтерді атай отырып, байланысты түзетуді сұрай алады. Профильдің өз жарияланған карточкасы өңдеу үшін он алтыға дейін үлгі суретке рұқсат береді. Тапсырмаға үлес қосатын үлгілерді таңдап, олардың мақсатын түсіндіріңіз: өнім, кейіпкер, фон немесе бейнелеу мәнері. Бірнеше үлгіде жарық не композиция бір-біріне қайшы болуы мүмкін, сондықтан көзделген нәтижені анық атаңыз. Нақты қайтарылған суреттен негізгі нысан бөлшектерін, жазуларды және сұралған өзгеріс шекараларын тексеріңіз. Мәтінді суретте көрсету — құжатталған мүмкіндік, бірақ көрнекі нобайдың әр сөзін бәрібір тексеру қажет. Нақты мәтінді, тыныс белгілерін және орналасуды беріп, маңызды белгілер мен сандарды тапсырмамен көзделген көрсету өлшемінде салыстырыңыз. Қайталанатын серия үшін үлгілер мен көрнекі талаптарды әр нәтижемен бірге сақтап, аяқталған суреттерді өзара салыстырыңыз. #### Жұмыс контексті және басқару мүмкіндіктері Біріктірілген профиль 400 000 токендік контекст терезесін және 128 000 токенге дейінгі генерацияны жариялайды. Бұлар — жұмыс контексті мен генерация лимиттері; олар суреттің пиксель өлшемдерінен немесе қайтарылған сурет материалдарының санынан бөлек. Ұзақ дереккөз материалын қажетті түсіндірудің айналасында ұйымдастырып, жауапқа орын қалдырыңыз. Тиісті үлгілері бар ықшам тапсырма рөлі түсіндірілмеген қатысы жоқ құжаттардан пайдалырақ. Жарияланған мәтіндік шығыс спецификациясы JSON-схема бойынша құрылымды нәтижелерді қолдайды. Жазбаша нәтижені қолданба пайдалануы қажет болса, өрістер мен түрлерді анықтап, мәндерді берілген дәлелдермен салыстырып тексеріңіз. Біріктірілген профиль қолданба функцияларын шақыруды қолжетімді етпейді. Тілдік құрамдасты сурет жасаумен бірге қолдану — осы профильдің аталған мүмкіндігі; бұл жеке GPT-5 Mini интерфейсінің әр мүмкіндігін осы үдерістің бөлігіне айналдырмайды. Сурет баптаулары қолданылып отырған нақты профильден және интерфейстен алынуы тиіс. Нұсқаларды салыстырғанда таңдалған конфигурацияны промптпен бірге сақтаңыз. Тікелей пайдаланылатын GPT Image 1 Mini құрамдасы мен біріктірілген чат профилінің сұрау құрылымдары бөлек; сондықтан құрамдасқа тән өлшем, маска немесе шығыс басқаруын осы біріктірілген профильдің баптауы деп қараудан бұрын олардың сәйкестігін айқын анықтау қажет. #### Мәтін мен сурет материалдарын сақтау Құжатталған чат сұрау схемасында шығыс түрлері ретінде text және image таңдауға болады. Қайтарылған мәтінді және генерациямен бірге берілген әрбір нақты сурет нәтижесін өңдеңіз. Суреттерді нәтижеде көрсетілген пішімде сақтап, жазбаша жауапты промптпен, дереккөз сілтемелерімен және баптаулармен бірге ұстаңыз. Тек түсіндіру мәтіні бар жауап дайын көрнекі материалдан бөлек, сондықтан оны макетке пайдаланбай тұрып нәтиженің нақты құрамын тексеріңіз. GPT-5 Image Mini GPT-5 пен GPT Image 1 біріктірілген толық GPT-5 Image профилінен бөлек. Mini профилін тапсырмасы мен тексеру өлшемдері анық, ауқымы шектелген тілдік және көрнекі жұмыстарға пайдаланыңыз. Композицияны, нысанның танылатын болмысын, сурет мәтінін және ілеспе мәтінді тексеріп, кейін қажетті нақты түзетуді сұраңыз. Өңдеудің нақты мақсаты болуы үшін келесі тапсырмада сәтті элементтер мен тиісті үлгілерді сақтаңыз. Практикалық тапсырма ### Практикалық тапсырма Ағылшын тіліндегі техникалық мысал ``` Create a labelled refill-bottle scene Create a product-scene image of a plain cylindrical blue reusable water bottle with a silver screw cap, standing upright on pale stone. Soft daylight enters from the left. Place the exact word REFILL clearly on the bottle, with no other text, logos, accessories or unsupported product claims. Keep the full bottle visible. ``` #### Күтілетін нәтиже ``` One image artifact showing the full specified bottle, left-side daylight and the exact single-word label. ``` #### Нәтижені тексеру ``` Inspect the actual image for bottle shape, cap, complete framing and letter-by-letter spelling of REFILL. ``` **Ailoot Ultra · OpenAI чаты** `POST /v1/chat/completions` `openai/gpt-5-image-mini` [`openai/gpt-5-image-mini`](https://ailoot.ai/models/kk/#m=openai%2Fgpt-5-image-mini&route=Ultra&caller=openai%2Fgpt-5-image-mini&fmt=chat) OpenAI /`openai/gpt-5-image-mini` ### Бастау GPT-5 Image Mini OpenAI ұсынған GPT-5 Mini тілдік мүмкіндіктерін GPT Image 1 Mini арқылы көрнекі материал жасау және үлгіге сүйеніп өңдеумен біріктіреді. Мәтін, сурет және құжаттарды қабылдап, мәтін мен суреттер қайтарады; жазбаша жауап пен көрнекі материал екеуі де қажет болатын үдерістерді қолдайды. Қабылданатын кіріс деректері Мәтін Нәтижелер Мәтін ### Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер **Ailoot Ultra · OpenAI чаты** `POST /v1/chat/completions` Кіріс `text` Шығыс `text` Шығыс пішімі json немесе SSE | Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі | | --- | --- | --- | --- | --- | | Өріс`model` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер openai/gpt-5-image-mini | Әдепкі— | | Өріс`messages` | Түрі`message[]` | ТалапМіндетті | Мәндер мен шектеулер Элементтердің ең аз саны: 1 | Әдепкі— | | Өріс`messages[].role` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер Мысалдар: system, user, assistant, tool, function Шарттар: Бұл рөлдер бастапқы кодтағы үйлесімділік түрлерінде айқын көрсетілген; рөлдердің нақты жиыны әр модельге байланысты. Модельге байланысты | Әдепкі— | | Өріс`messages[].content` | Түрі`string\|content_part[]\|null` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— | | Өріс`messages[].tool_calls` | Түрі`tool_call[]` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— | | Өріс`messages[].tool_call_id` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер Мына жағдайда қолданылады: role=tool; нақты қайтарылған ID мәнін пайдаланыңыз | Әдепкі— | | Өріс`messages[].name` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— | | Өріс`messages[].reasoning_content` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер Мына жағдайда қолданылады: Модель пайымдауды пайдаланса, нақты қайтарылған пайымдауды қайта жіберіңіз | Әдепкі— | | Өріс`messages[].reasoning_details` | Түрі`object\|array` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`max_tokens` | Түрі`integer` | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 Модельге байланысты | Әдепкі— | | Өріс`max_completion_tokens` | Түрі`integer` | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 Модельге байланысты | Әдепкі— | | Өріс`stream` | Түрі`boolean` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse | | Өріс`stream_options.include_usage` | Түрі`boolean` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`temperature` | Түрі`number` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`top_p` | Түрі`number` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`stop` | Түрі`string\|string[]` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`tools` | Түрі`function_tool[]` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`tools[].type` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер function Модельге байланысты | Әдепкі— | | Өріс`tools[].function.name` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер Мына жағдайда қолданылады: функция құралы берілген | Әдепкі— | | Өріс`tools[].function.description` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— | | Өріс`tools[].function.parameters` | Түрі`JSON_schema` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— | | Өріс`tool_choice` | Түрі`string\|object` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`parallel_tool_calls` | Түрі`boolean` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`response_format` | Түрі`object` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`reasoning_effort` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`reasoning` | Түрі`object` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`service_tier` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`instructions` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер Үйлесімділік өрісі | Әдепкі— | | Өріс`functions` | Түрі`function[]` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`function_call` | Түрі`string\|object` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`prompt_cache_options` | Түрі`object` | ТалапМіндетті емес | Мәндер мен шектеулер Модельге байланысты | Әдепкі— | | Өріс`modalities` | Түрі`string[]` | ТалапМіндетті емес | Мәндер мен шектеулер text | Әдепкі— | | Өріс`provider` | Түрі`object` | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Осы Ultra мәтіндік бағытында provider.options қабылданбайды | Әдепкі— | | Өріс`cache_control.ttl` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Сұрау кэшінің нақты орындарында 1h қабылданбайды | Әдепкі— | Кіріс материалдарының үйлесімдері **Мәтін** · UTF8 мәтіні `messages[].content` Әдіс параметрлері мен өмірлік циклі | Параметр | Параметр талаптары | | --- | --- | | Параметр`content_type` | Параметр талаптарыapplication/json | | Параметр`required` | Параметр талаптарыmodel, messages | | Параметр`material_types` | Параметр талаптарыtext | | Параметр`messages` | Параметр талаптарыrole/content құрылымы бар хабарламалар жиымы | | Параметр`file_material` | Параметр талаптарынақты UTF-8 құжаты сөзбе-сөз мәтін ретінде енгізіледі; файл ID-і болжанбайды | | Параметр`optional_controls` | Параметр талаптарыstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Параметр`control_scope` | Параметр талаптарымодельге байланысты; пайдаланушының функция құралдары қызмет жағында орындалатын құралдардан өзгеше | | Параметр`output_modalities` | Параметр талаптарыtext | | Параметр`hosted_operations` | Параметр талаптарыfalse | | Параметр`multimodal_input_binding` | Параметр талаптарыnull | Өмірлік цикл: `synchronous_or_streamed` Модельдің дәл ID мәнін messages деректерімен бірге жіберіңіз. Контекст ұзындығы шығыстың жоғарғы шегі емес. Мәтіндік файл сөзбе-сөз мәтінді бере алады; кіріс суреттері, аудио және файл нысандары дәл байланыстыруды қажет етеді. ### Тарифтер Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген. Жылдам режим Стандартты тариф Жылдам режим таңдалғанда Икемді режим Стандартты тариф flex режимі таңдалғанда Ой қорытудың ең жоғары деңгейі Стандартты тариф Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда #### Ailoot мөлшерлемелері #### Баптаулар бойынша бағалар Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз. | Баптау | Мөлшерлемелер кестесі | Контекст токендерінің саны мынадан көп | Контекст токендерінің саны мынадан аспайды, шегі кіреді | Төлем | | --- | --- | --- | --- | --- | | БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Контекст токендерінің саны мынадан көп— | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері **$0.005** / 1K токен Шығыс · Шығыс токендері **$0.004** / 1K токен Кіріс · Кэшті оқу **$0.0005** / 1K токен Кіріс · Кэшке жазу **—** / 1K токен Кіріс · Кэшке жазу, 1 сағ **—** / 1K токен Шығыс · Шығыс кескін токендері **$0.016** / 1K сурет токені | | БаптауСұрау ұзындығының 1-деңгейі | Мөлшерлемелер кестесі— | Контекст токендерінің саны мынадан көп0 | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері **$0.005** / 1K токен Шығыс · Шығыс токендері **$0.004** / 1K токен Кіріс · Кэшті оқу **$0.0005** / 1K токен Кіріс · Кэшке жазу **—** / 1K токен Кіріс · Кэшке жазу, 1 сағ **—** / 1K токен | #### Анықтамалық тариф мәліметтері Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі. OpenAI: GPT-5 Image Mini #### Баптаулар бойынша бағалар | Баптау | Төлемді есептеу шарттары | Төлем | | --- | --- | --- | | БаптауOpenAI: GPT-5 Image Mini · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс токендері **0,005 $** / 1K токен Шығыс · Шығыс токендері **0,004 $** / 1K токен Шығыс · Шығыс кескін **0,016 $** / 1K токен Шығыс · Веб-іздеу **0,02 $** әр іздеу үшін Кіріс · Кэшті оқу **0,0005 $** / 1K токен | Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. [Резервтеу мен төлемді есептеу тәртібі →](https://ailoot.ai/docs/kk/billing/reserve/) ### Сұрау мысалдары #### Ailoot Ultra · OpenAI чаты curlPython SDKPython ағыны ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "openai/gpt-5-image-mini", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='openai/gpt-5-image-mini',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='openai/gpt-5-image-mini',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### Нәтижелерді алу және сақтау #### Ailoot Ultra · OpenAI чаты json немесе SSE ##### Барлық дайын нәтижені сақтау Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз. Әр жауап нұсқасын оның мазмұнымен, құрал шақыруларымен және пайымдауымен бірге сақтаңыз. SSE өзгерістерін жауап нұсқасы мен құрал индексі бойынша жинап, соңғы аяқталу себебі мен пайдалану деректерін сақтаңыз. ##### Бастапқы жауапты тексеру қажет болса Сұрау мен жауаптың ID мәндерін және тақырыптарын сақтаңыз. Мәтіндік тапсырманы алуға арналған ортақ URL берілмеген. Жауап өрістері | Өріс | Түрі | | --- | --- | | Өріс`choices[].index` | Түріinteger | | Өріс`choices[].message.content` | Түріstring\|null | | Өріс`choices[].message.tool_calls` | Түріtool\_call\[\] | | Өріс`choices[].message.reasoning_content` | Түріstring | | Өріс`choices[].message.reasoning_details` | Түріobject\|array | | Өріс`choices[].finish_reason` | Түріstring\|null | | Өріс`usage` | Түріobject | Қателер және келесі қадамдар | Жауап | Шарт | Келесі қадам | | --- | --- | --- | | Жауап400 · `invalid_request_error` | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. | ### Балама атаулар #### Модельдердің балама атаулары **Ailoot Ultra** [`openai/gpt-5-image-mini`](https://ailoot.ai/models/kk/#m=openai%2Fgpt-5-image-mini&route=Ultra&caller=openai%2Fgpt-5-image-mini&fmt=chat) #### Әдіс жолдарының балама атаулары `/v1/images` #### Шақыруға арналған байланысты ID [`openai/gpt-5-image-mini`](https://ailoot.ai/models/kk/#m=openai%2Fgpt-5-image-mini&route=Ultra&caller=openai%2Fgpt-5-image-mini&fmt=chat) **Ailoot Ultra · Суреттер** `POST /v1/images/generations` `openai/gpt-5-image-mini` [`openai/gpt-5-image-mini`](https://ailoot.ai/models/kk/#m=openai%2Fgpt-5-image-mini&route=Ultra&caller=openai%2Fgpt-5-image-mini&fmt=images) OpenAI /`openai/gpt-5-image-mini` ### Бастау GPT-5 Image Mini OpenAI ұсынған GPT-5 Mini тілдік мүмкіндіктерін GPT Image 1 Mini арқылы көрнекі материал жасау және үлгіге сүйеніп өңдеумен біріктіреді. Мәтін, сурет және құжаттарды қабылдап, мәтін мен суреттер қайтарады; жазбаша жауап пен көрнекі материал екеуі де қажет болатын үдерістерді қолдайды. Қабылданатын кіріс деректері Мәтін · Суреттер Нәтижелер Суреттер ### Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер **Ailoot Ultra · Суреттер** `POST /v1/images/generations` Кіріс `text`, `image` Шығыс `image` | Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі | | --- | --- | --- | --- | --- | | Өріс`model` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер openai/gpt-5-image-mini | Әдепкі— | | Өріс`prompt` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— | | Өріс`aspect_ratio` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер 1:1, 3:2, 2:3, auto | Әдепкі— | | Өріс`quality` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер auto, low, medium, high | Әдепкі— | | Өріс`background` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер auto, transparent, opaque | Әдепкі— | | Өріс`n` | Түрі`integer` | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 Ең көбі: 10 | Әдепкі— | | Өріс`input_references` | Түрі`array` | ТалапМіндетті емес | Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 16 | Әдепкі— | | Өріс`output_compression` | Түрі`integer` | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 0 Ең көбі: 100 | Әдепкі— | | Өріс`provider` | Түрі`object` | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— | Әдіс параметрлері мен өмірлік циклі | Параметр | Параметр талаптары | | --- | --- | | Параметр`content_type` | Параметр талаптарыapplication/json | | Параметр`required` | Параметр талаптарыmodel, prompt | | Параметр`material_types` | Параметр талаптарыtext, image | Өмірлік цикл: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · Нақты қайтарылған task\_id немесе медиатека жазбасы `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Тарифтер ##### Қорытынды төлем қалай есептеледі Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды. Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген. Жылдам режим Көрсетілмеген Жылдам режим таңдалғанда Икемді режим Көрсетілмеген flex режимі таңдалғанда Ой қорытудың ең жоғары деңгейі Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда #### Салыстыруға арналған болжамды мөлшерлемелер #### Баптаулар бойынша бағалар Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз. | Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем | | --- | --- | --- | --- | | БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау **—** / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау **—** / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау **—** / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау **—** / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау **—** / 1K токен | | БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау **$0.065536** жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. | Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. [Резервтеу мен төлемді есептеу тәртібі →](https://ailoot.ai/docs/kk/billing/reserve/) ### Сұрау мысалдары #### Ailoot Ultra · Суреттер curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'openai/gpt-5-image-mini', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"