Source: https://ailoot.ai/models/kk/google-gemini-2-5-flash-image/ Canonical: https://ailoot.ai/models/kk/google-gemini-2-5-flash-image/ Language: kk # Google: Nano Banana (Gemini 2.5 Flash Image) [Markdown](https://ailoot.ai/models/kk/google-gemini-2-5-flash-image/index.md) · [JSON](https://ailoot.ai/models/kk/google-gemini-2-5-flash-image/facts.json) ## [Google: Nano Banana (Gemini 2.5 Flash Image)](https://ailoot.ai/models/kk/google-gemini-2-5-flash-image/) Nano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз. - [**Ailoot Ultra · OpenAI чаты** `POST /v1/chat/completions` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/kk/google-gemini-2-5-flash-image/#method-0) - [**Ailoot Ultra · Суреттер** `POST /v1/images/generations` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/kk/google-gemini-2-5-flash-image/#method-1) - [**Ailoot Ultra · Anthropic хабарламалары** `POST /v1/messages` `google/gemini-2.5-flash-image`](https://ailoot.ai/models/kk/google-gemini-2-5-flash-image/#method-2) Модель туралы Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген. Gemini 2.5 Flash Image (Nano Banana деп те белгілі) — көрнекі материалдар жасауға және диалог арқылы кескін өңдеуге арналған Google компаниясының мәтін-кескін моделі. Ол міндетті емес кескін референстері бар нұсқауды қабылдап, қосымша мәтіні бар кескіндер қайтара алады. Дәл осы 2.5 Flash Image нұсқасы Nano Banana 2, Nano Banana Pro және кейінгі Lite кескін модельдерінен бөлек. Оның пайдалы нәтижесі — жалпы Gemini 2.5 мәтін моделінің жауабы емес, жасалған не түзетілген көрнекі материал. Дәл модель картасы 65,536 кіріс және 32,768 шығыс токенін көрсетеді. Кескіндер мен нұсқаулар кірістің бөлігі, ал қайтарылған кескін не мәтін нәтиженің бөлігі болады. Нұсқаулықтың ажыратымдылық кестесі қолдайтын кескін ені мен биіктігінің арақатынастары арасында 1:1 шығысты 1024×1024, 3:4 шығысты 864×1184 және 16:9 шығысты 1344×768 деп береді. Көріністі жобаламас бұрын көзделген көрсету пішінін таңдаңыз. Кейінгі Gemini кескін нұсқасының жоғары ажыратымдылық таңдауларын дәл осы модельге құжатталған басқарулар деп қабылдауға болмайды. Мәтіннен кескін жасауда нысанды, әрекетті, ортаны, стильді, жарықты және ракурсты көрсетіңіз. Тауар иллюстрациясы берілген визуалдық айдентиканы пайдаланып, тиісті ортада материалдың анық көрінетін бөлшегін сұрай алады. Модель нысан мен мәтінге орын бөлуі үшін суреттің мақсатын түсіндіріңіз. Жақын көрініс, үстінен түсірілген композиция немесе төмен бұрышты перспектива сияқты фотографиялық сипаттамалар байланыссыз стиль сөздерінің тізімінен гөрі кадрлауды анығырақ белгілейді. Өңдеуге түпнұсқа кескінді беріп, өзгеретін бөлікті көрсетіңіз. Өндіруші нұсқаулығы элементтер қосуды не алуды, семантикалық маскалауды, стиль көшіруді және референстермен композиция құруды сипаттайды. Пайдалы сұрау түзетуді де, сақталатын шарттарды да атайды: мысалы, тауар пішінін, бетін және жапсырмасын сақтап, фонды өзгерту. Референстерді біріктіргенде әр кірістің нысан келбеті, орта немесе стиль сияқты рөлін белгілеңіз. Нұсқаулық осы нұсқа үшке дейін кіріс кескінімен ең жақсы жұмыс істейтінін айтады; бұл қайшы референстердің шексіз жиынын біріктіруге себеп емес, іс жүзіндегі кеңес. Диалогтік жетілдіру нақты көрнекі шешімді өзгертіп, сол нысанды сақтай алады. Әр жолы бір байланысты түзетуді сұрап, сол кезекте қолданылған бастапқы кескін мен қабылданған нәтижені сақтаңыз. Не бірізді қалуы және не өзгеруі мүмкін екенін сипаттаңыз. Көрнекі материалдар тізбегінде жаңа оқшау промпт оларды өзі қалпына келтіреді деп болжамай, ортақ нысанды, түстерді және көрнекі ережелерді нақты анықтаңыз. Сақтау нұсқауы сәтті орындалды деп есептемес бұрын түзетілген кескінді референспен салыстырыңыз. Кескін ішіндегі мәтінде нұсқаулық ұсынғандай, алдымен нақты сөздерді бекітіп, кейін сол мәтіні бар суретті сұраңыз. Белгілердің тілін, оқу ретін, орнын және салыстырмалы екпінін айтыңыз. Инфографика сұрауы әр белгі түсіндіретін қатынасты және оны қолдайтын көрнекі элементтерді анықтауы тиіс. Нақты көрсету өлшемінде емлені, тыныс белгілерін және көрнекі байланысты тексеріңіз; оқылатын сияқты жасалған белгі бәрібір есімді, санды немесе көзделген мағынаны өзгерте алады. Модель картасы осы нұсқа үшін ойлауды, іздеу арқылы негіздеуді, функция шақыруды, код орындауды немесе шектелген құрылымдалған шығысты тізімдемейді. Ол аудио генерациясын не Live API-ді де ұсынбайды. Құжатталған кірісі — мәтін мен кескіндер, сондықтан басқа Gemini модельдерінің аудио, бейне және құжат өңдеу мүмкіндіктерін осы профильге телуге болмайды. Қолданба кәдімгі прозалық жауапта дайын кескін материалы бар деп болжамай, қайтарылған мазмұн бөліктерін нақты өңдеуі керек. Нұсқаулық сұралған кескін саны әрдайым орындалмауы мүмкін екенін және жасалған кескіндерде SynthID белгісі барын айтады. Әр қайтарылған кескінді композицияға, нысан дәлдігіне, нысан санына және нақты сөздерге тексеріңіз. Көріністе бірнеше компонент болса, көзделген орналасуын анық ретпен сипаттап, қажетті келбетті оң тұжырыммен беріңіз. Модельдің нақты атауын, промптты және референстерді нәтижемен бірге сақтаңыз. Бұл көрнекі генерация не өңдеу тапсырмасын тексерілетін етіп, кейінгі түзетуге нақты бастапқы негіз береді. Практикалық тапсырма ### Практикалық тапсырма Ағылшын тіліндегі техникалық мысал ``` Change a product photo background Using the supplied product photograph, preserve the ceramic mug's shape, handle, glaze and existing logo exactly. Replace only the background with a pale stone tabletop and soft morning side light. Keep the camera angle and mug position. Remove unrelated background clutter and add no new lettering, props or decorative marks. ``` #### Күтілетін нәтиже ``` An edited image retaining the reference mug while changing its setting and light as requested. ``` #### Нәтижені тексеру ``` Compare the result with the reference for mug geometry, logo fidelity, camera angle and removal of clutter. ``` **Ailoot Ultra · OpenAI чаты** `POST /v1/chat/completions` `google/gemini-2.5-flash-image` [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/kk/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) Google /`google/gemini-2.5-flash-image` ### Бастау Nano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз. Қабылданатын кіріс деректері Мәтін Нәтижелер Мәтін ### Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер **Ailoot Ultra · OpenAI чаты** `POST /v1/chat/completions` Кіріс `text` Шығыс `text` Шығыс пішімі json немесе SSE | Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі | | --- | --- | --- | --- | --- | | Өріс`model` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер google/gemini-2.5-flash-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.0006** / 1K токен Шығыс · Шығыс токендері **$0.005** / 1K токен Кіріс · Кэшті оқу **$0.00006** / 1K токен Кіріс · Кэшке жазу **$0.0001666666666666666** / 1K токен Кіріс · Кэшке жазу, 1 сағ **—** / 1K токен Шығыс · Шығыс кескін токендері **$0.06** / 1K сурет токені | | БаптауСұрау ұзындығының 1-деңгейі | Мөлшерлемелер кестесі— | Контекст токендерінің саны мынадан көп0 | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері **$0.0006** / 1K токен Шығыс · Шығыс токендері **$0.005** / 1K токен Кіріс · Кэшті оқу **$0.00006** / 1K токен Кіріс · Кэшке жазу **$0.0001666666666666666** / 1K токен Кіріс · Кэшке жазу, 1 сағ **—** / 1K токен | #### Анықтамалық тариф мәліметтері Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі. google/gemini-2.5-flash-image #### Баптаулар бойынша бағалар | Баптау | Төлемді есептеу шарттары | Төлем | | --- | --- | --- | | Баптауgoogle/gemini-2.5-flash-image · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс **0,0006 $** / 1K токен Шығыс · Шығыс **0,06 $** / 1K токен | Google: Nano Banana (Gemini 2.5 Flash Image) #### Баптаулар бойынша бағалар | Баптау | Төлемді есептеу шарттары | Төлем | | --- | --- | --- | | БаптауGoogle: Nano Banana (Gemini 2.5 Flash Image) · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс токендері **0,0006 $** / 1K токен Шығыс · Шығыс токендері **0,005 $** / 1K токен Кіріс · Кіріс кескін **0,0006 $** / 1K токен Шығыс · Шығыс кескін **0,06 $** / 1K токен Кіріс · Аудио кірісі **0,002 $** / 1K токен Кіріс · Аудио кэшінен оқу **0,0002 $** / 1K токен Шығыс · Веб-іздеу **0,028 $** әр іздеу үшін Шығыс · Пайымдау токендері **0,005 $** / 1K токен Кіріс · Кэшті оқу **0,00006 $** / 1K токен Кіріс · Кэшке жазу · 5 минут **≈0,000167 $** / 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": "google/gemini-2.5-flash-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='google/gemini-2.5-flash-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='google/gemini-2.5-flash-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** [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/kk/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) #### Әдіс жолдарының балама атаулары `/v1/images` #### Шақыруға арналған байланысты ID [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/kk/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=chat) **Ailoot Ultra · Суреттер** `POST /v1/images/generations` `google/gemini-2.5-flash-image` [`google/gemini-2.5-flash-image`](https://ailoot.ai/models/kk/#m=google%2Fgemini-2.5-flash-image&route=Ultra&caller=google%2Fgemini-2.5-flash-image&fmt=images) Google /`google/gemini-2.5-flash-image` ### Бастау Nano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз. Қабылданатын кіріс деректері Мәтін · Суреттер Нәтижелер Суреттер ### Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер **Ailoot Ultra · Суреттер** `POST /v1/images/generations` Кіріс `text`, `image` Шығыс `image` | Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі | | --- | --- | --- | --- | --- | | Өріс`model` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер google/gemini-2.5-flash-image | Әдепкі— | | Өріс`prompt` | Түрі`string` | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— | | Өріс`aspect_ratio` | Түрі`string` | ТалапМіндетті емес | Мәндер мен шектеулер 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | Әдепкі— | | Өріс`n` | Түрі`integer` | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 Ең көбі: 1 | Әдепкі— | | Өріс`input_references` | Түрі`array` | ТалапМіндетті емес | Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 3 | Әдепкі— | | Өріс`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.24576** жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. | 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': 'google/gemini-2.5-flash-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"