Source: https://ailoot.ai/models/kk/openai-gpt-5-image/ Canonical: https://ailoot.ai/models/kk/openai-gpt-5-image/ Language: kk # OpenAI: GPT-5 Image [Markdown](https://ailoot.ai/models/kk/openai-gpt-5-image/index.md) · [JSON](https://ailoot.ai/models/kk/openai-gpt-5-image/facts.json) ## [OpenAI: GPT-5 Image](https://ailoot.ai/models/kk/openai-gpt-5-image/) GPT-5 Image OpenAI компаниясының GPT-5 тілдік және пайымдау мүмкіндіктерін сурет жасауға және референстерге сүйеніп өңдеуге арналған GPT Image 1 моделімен біріктіреді. Профиль мәтін, сурет және құжаттарды қабылдап, мәтін мен суреттерді қайтарады, осылайша жазбаша тапсырманы көрнекі нәтижемен байланыстырады. - [**Ailoot Ultra · OpenAI чаты** `POST /v1/chat/completions` `openai/gpt-5-image`](https://ailoot.ai/models/kk/openai-gpt-5-image/#method-0) - [**Ailoot Ultra · Суреттер** `POST /v1/images/generations` `openai/gpt-5-image`](https://ailoot.ai/models/kk/openai-gpt-5-image/#method-1) - [**Ailoot Ultra · Anthropic хабарламалары** `POST /v1/messages` `openai/gpt-5-image`](https://ailoot.ai/models/kk/openai-gpt-5-image/#method-2) Модель туралы Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген. GPT-5 Image — OpenAI компаниясының GPT-5 тілдік моделін GPT Image 1 моделімен біріктіретін құрамдас профиль. Тілдік бөлік талаптар мен бастапқы материалды түсіндіреді, ал сурет бөлігі көрнекі нәтиже жасайды. Жарияланған сипаттамада пайымдау, нұсқауларды орындау, суретте мәтін бейнелеу және суреттерді егжей-тегжейлі өңдеу ерекшеленеді. Профиль көрнекі материал мен оның жазбаша түсіндірмесі бір тапсырмаға сай болуы тиіс жұмыстарға жарайды. #### Тапсырманы түсіндіріп, көрнекі материал жасаңыз Модельге суреттің мақсатын, көзделген аудиторияны және міндетті мазмұнын беріңіз. Дәл көрсетілуі тиіс фактілерді композиция немесе көрнекі стиль таңдауынан ажыратыңыз. Сызба тапсырмасында нысандар мен байланыстарды атап, содан кейін жазуларды, орналасуды және стильді белгілеуге болады. Плакат тапсырмасында іс-шара деректерін, иерархияны және көріністі анықтап, суретке кіретін нақты сөздерді беруге болады. Мысалы, көпшілікке арналған ғылыми іс-шара плакатының тұжырымдамасын дайындаңыз. Іс-шара фактілерін беріп, орналасуын қысқаша түсіндіруді және анық тақырыбы мен оны толықтыратын көрнекі элементтері бар сурет жасауды сұраңыз. Қай сөздер суретте, ал қайсысы тек ілеспе сипаттамада болуы керегін көрсетіңіз. Жазбаша түсіндірме мен жасалған плакатты бірге тексеріп, қисынды орналасу жоспарын нақты көрінетін нәтижемен салыстырыңыз. Мәтін, суреттер және PDF сияқты файлдар құрамдас профильдің құжатталған кірістері болып саналады. Құжат көрнекі материал талаптарын немесе жинақталатын ақпаратты бере алады. Референс суреттер нысанды, тауарды, орынды немесе орналасуды айқындай алады. Нәтижені сипаттаудан бұрын әр дереккөзді атап, оның рөлін түсіндіріңіз, әсіресе референсте сақталатын да, өзгертілетін де мазмұн болса. #### Референстерге сүйеніп өңдеу және мәтін бейнелеу Түзету үшін бастапқы суретті көрсетіп, сұралған өзгерісті дәл сипаттаңыз. Тауар көрінісін өңдегенде заттың пішіні мен көрінетін таңбаларын сақтап, ортасын өзгертуге болады. Көрнекі түсіндірмеде айналадағы байланыстарды сақтап, бір элементті ауыстыруға болады. Сақтау талаптарын тапсырмада көрсетіп, маңызды бөлшектерді нақты суреттен тексеріңіз. Дәл осы құрамдас профильдің карточкасы өңдеу үшін он алтыға дейін референс суретке рұқсат береді. Тапсырмаға қатысты референстерді ғана қолданып, әрқайсысы қандай белгілер беретінін түсіндіріңіз. Бірнеше суреттің жарығы, қарау бұрышы немесе көрнекі стилі әртүрлі болса, әр дереккөзді нәтижеде басым етуді сұраудың орнына көзделген композицияны атаңыз. Кейінгі түзету сол материалға сүйене алуы үшін дереккөздерді дайын суретпен бірге сақтаңыз. Жарияланған профиль мәтінді суретте бейнелеуді өз мүмкіндіктеріне қосады. Маңызды мәтіннің нақты сөздерін, тыныс белгілерін және орнын беріп, оның нысандармен немесе басқа жазулармен байланысын көрсетіңіз. Қайтарылған суреттегі әр міндетті сөз бен санды көзделген көрсету өлшемінде тексеріңіз. Сызбадағы сызықтар, орындар және топтар жазбаша дереккөзде сипатталған байланысты білдіретінін де тексеріңіз. #### Контекст және жауап пішімі Құрамдас профиль 400 000 токендік контекст терезесін және 128 000 токенге дейінгі аяқтау көлемін жариялайды. Бұл көлемдер белгілі бір пиксель өлшемін немесе сурет санын емес, кіріс пен жасалған аяқтауды сипаттайды. Контексті қажетті талаптарға, референстерге және әңгіме күйіне пайдаланып, сұралған шығысқа орын қалдырыңыз. Модель әр нұсқауды тиісті үзіндімен байланыстыра алуы үшін ұзын бастапқы материалды белгілеңіз. Құжатталған мәтіндік шығыс спецификациясы JSON схемасы арқылы құрылымды нәтижелерді қолдайды. Жазбаша жауап тұжырымдаманы сипаттауға, талапты жинақтауға немесе сұралған өзгерісті белгілеуге арналған өрістерді анықтай алады. Қолданба оларды пайдаланғанға дейін өрістер мен мәндерді дереккөзге салыстырып тексеріңіз. Аталған тілдік және сурет бөліктері көрнекі генерацияны іштей орындағанымен, құрамдас профиль қолданба функцияларын шақыруды ұсынбайды. Чат сұрауының схемасы мәтін мен суретті шығыс модальдықтары ретінде таңдауға мүмкіндік береді. Тапсырмада нақты жазбаша және көрнекі нәтижелерді атап, аяқталған жауапта екеуінің де барын тексеріңіз. Сурет баптаулары нақты модель мен интерфейске тән. Қабылданған баптауларды сұраумен бірге сақтап, тек осы құрамдас профиль үшін құжатталған басқару параметрлерін қолданыңыз; сурет бөлігіне тікелей жүгіну интерфейсінің өрістері мен мүмкіндіктері басқаша болуы мүмкін. #### Аталған құрамды саналы таңдаңыз Бұл профильдің сурет бөлігі — GPT Image 1. Оның тікелей сурет жасау профилі суретке бағытталған жұмыстарды орындайды, ал GPT-5 Image осы мүмкіндікті GPT-5 тілдік өңдеуімен біріктіреді. GPT-5 Image Mini — GPT-5 Mini және GPT Image 1 Mini модельдерінің бөлек үйлесімі. Ұқсас атаулы үйлесімдерді бір модель деп қарастырмай, таңдалған профильдің сәйкестендіру деректерін бастапқы материалмен және шығыс баптауларымен бірге сақтаңыз. Бірнеше түзетуі бар әңгімеде қажетті жазбаша талаптар мен бастапқы референстерді келесі қадамға жеткізіңіз. Ең жаңа тапсырмада жазуды жылжыту, нысанды өзгерту немесе композицияны оңайлату сияқты нақты түзетуді атаңыз. Пайдалы өзгеріс қайтарылған материалдан көрініп тұрса, бәрін жақсарту туралы бағытсыз өтініштен аулақ болыңыз. #### Дайын нәтижені сақтап, тексеріңіз Жазбаша жауапты және аяқтауда берілген әр нақты сурет файлын сақтаңыз. Суреттерді көрсетілген пішімінде, тапсырма мәтінімен, бастапқы референстермен және таңдалған баптаулармен бірге сақтаңыз. Композицияны, нысан бөлшектерін және мәтінді суреттің өзінен тексеріп, ілеспе мәтінді ол сипаттайтын деректермен салыстырыңыз. Пайдалы дайын нәтиже жазбаша талаптарды ашуға, тексеруге және қажетті құжатқа, бетке немесе шығармашылық жұмысқа орналастыруға болатын көрнекі материалмен байланыстырады. Практикалық тапсырма ### Практикалық тапсырма Ағылшын тіліндегі техникалық мысал ``` Simplify a community-event poster Edit the supplied community science poster. Preserve the exact event title, date, venue and central telescope illustration. Remove the small decorative stars around the footer, increase the empty space around the title and keep the original portrait layout and two-color palette. Add no new event facts or text. Return the revised poster image. ``` #### Күтілетін нәтиже ``` A revised poster image retaining all event wording and the telescope while simplifying the requested areas. ``` #### Нәтижені тексеру ``` Check every event word and number against the source and confirm that only the named decorative elements were removed. ``` **Ailoot Ultra · OpenAI чаты** `POST /v1/chat/completions` `openai/gpt-5-image` [`openai/gpt-5-image`](https://ailoot.ai/models/kk/#m=openai%2Fgpt-5-image&route=Ultra&caller=openai%2Fgpt-5-image&fmt=chat) OpenAI /`openai/gpt-5-image` ### Бастау GPT-5 Image OpenAI компаниясының GPT-5 тілдік және пайымдау мүмкіндіктерін сурет жасауға және референстерге сүйеніп өңдеуге арналған GPT Image 1 моделімен біріктіреді. Профиль мәтін, сурет және құжаттарды қабылдап, мәтін мен суреттерді қайтарады, осылайша жазбаша тапсырманы көрнекі нәтижемен байланыстырады. Қабылданатын кіріс деректері Мәтін Нәтижелер Мәтін ### Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер **Ailoot Ultra · OpenAI чаты** `POST /v1/chat/completions` Кіріс `text` Шығыс `text` Шығыс пішімі json немесе SSE | Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі | | --- | --- | --- | --- | --- | | Өріс`model` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер openai/gpt-5-image | Әдепкі— | | Өріс`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.02** / 1K токен Шығыс · Шығыс токендері **$0.02** / 1K токен Кіріс · Кэшті оқу **$0.0025** / 1K токен Кіріс · Кэшке жазу **—** / 1K токен Кіріс · Кэшке жазу, 1 сағ **—** / 1K токен Шығыс · Шығыс кескін токендері **$0.08** / 1K сурет токені | | БаптауСұрау ұзындығының 1-деңгейі | Мөлшерлемелер кестесі— | Контекст токендерінің саны мынадан көп0 | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері **$0.02** / 1K токен Шығыс · Шығыс токендері **$0.02** / 1K токен Кіріс · Кэшті оқу **$0.0025** / 1K токен Кіріс · Кэшке жазу **—** / 1K токен Кіріс · Кэшке жазу, 1 сағ **—** / 1K токен | #### Анықтамалық тариф мәліметтері Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі. OpenAI: GPT-5 Image #### Баптаулар бойынша бағалар | Баптау | Төлемді есептеу шарттары | Төлем | | --- | --- | --- | | БаптауOpenAI: GPT-5 Image · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс токендері **0,02 $** / 1K токен Шығыс · Шығыс токендері **0,02 $** / 1K токен Шығыс · Шығыс кескін **0,08 $** / 1K токен Шығыс · Веб-іздеу **0,02 $** әр іздеу үшін Кіріс · Кэшті оқу **0,0025 $** / 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", "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',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',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`](https://ailoot.ai/models/kk/#m=openai%2Fgpt-5-image&route=Ultra&caller=openai%2Fgpt-5-image&fmt=chat) #### Әдіс жолдарының балама атаулары `/v1/images` #### Шақыруға арналған байланысты ID [`openai/gpt-5-image`](https://ailoot.ai/models/kk/#m=openai%2Fgpt-5-image&route=Ultra&caller=openai%2Fgpt-5-image&fmt=chat) **Ailoot Ultra · Суреттер** `POST /v1/images/generations` `openai/gpt-5-image` [`openai/gpt-5-image`](https://ailoot.ai/models/kk/#m=openai%2Fgpt-5-image&route=Ultra&caller=openai%2Fgpt-5-image&fmt=images) OpenAI /`openai/gpt-5-image` ### Бастау GPT-5 Image OpenAI компаниясының GPT-5 тілдік және пайымдау мүмкіндіктерін сурет жасауға және референстерге сүйеніп өңдеуге арналған GPT Image 1 моделімен біріктіреді. Профиль мәтін, сурет және құжаттарды қабылдап, мәтін мен суреттерді қайтарады, осылайша жазбаша тапсырманы көрнекі нәтижемен байланыстырады. Қабылданатын кіріс деректері Мәтін · Суреттер Нәтижелер Суреттер ### Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер **Ailoot Ultra · Суреттер** `POST /v1/images/generations` Кіріс `text`, `image` Шығыс `image` | Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі | | --- | --- | --- | --- | --- | | Өріс`model` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер openai/gpt-5-image | Әдепкі— | | Өріс`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.32768** жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. | 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', '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"