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 белгісі барын айтады. Әр қайтарылған кескінді композицияға, нысан дәлдігіне, нысан санына және нақты сөздерге тексеріңіз. Көріністе бірнеше компонент болса, көзделген орналасуын анық ретпен сипаттап, қажетті келбетті оң тұжырыммен беріңіз. Модельдің нақты атауын, промптты және референстерді нәтижемен бірге сақтаңыз. Бұл көрнекі генерация не өңдеу тапсырмасын тексерілетін етіп, кейінгі түзетуге нақты бастапқы негіз береді.
", "aboutText": "Gemini 2.5 Flash Image (Nano Banana деп те белгілі) — көрнекі материалдар жасауға және диалог арқылы кескін өңдеуге арналған Google компаниясының мәтін-кескін моделі. Ол міндетті емес кескін референстері бар нұсқауды қабылдап, қосымша мәтіні бар кескіндер қайтара алады. Дәл осы 2.5 Flash Image нұсқасы Nano Banana 2, Nano Banana Pro және кейінгі Lite кескін модельдерінен бөлек. Оның пайдалы нәтижесі — жалпы Gemini 2.5 мәтін моделінің жауабы емес, жасалған не түзетілген көрнекі материал.\n\nДәл модель картасы 65,536 кіріс және 32,768 шығыс токенін көрсетеді. Кескіндер мен нұсқаулар кірістің бөлігі, ал қайтарылған кескін не мәтін нәтиженің бөлігі болады. Нұсқаулықтың ажыратымдылық кестесі қолдайтын кескін ені мен биіктігінің арақатынастары арасында 1:1 шығысты 1024×1024, 3:4 шығысты 864×1184 және 16:9 шығысты 1344×768 деп береді. Көріністі жобаламас бұрын көзделген көрсету пішінін таңдаңыз. Кейінгі Gemini кескін нұсқасының жоғары ажыратымдылық таңдауларын дәл осы модельге құжатталған басқарулар деп қабылдауға болмайды.\n\nМәтіннен кескін жасауда нысанды, әрекетті, ортаны, стильді, жарықты және ракурсты көрсетіңіз. Тауар иллюстрациясы берілген визуалдық айдентиканы пайдаланып, тиісті ортада материалдың анық көрінетін бөлшегін сұрай алады. Модель нысан мен мәтінге орын бөлуі үшін суреттің мақсатын түсіндіріңіз. Жақын көрініс, үстінен түсірілген композиция немесе төмен бұрышты перспектива сияқты фотографиялық сипаттамалар байланыссыз стиль сөздерінің тізімінен гөрі кадрлауды анығырақ белгілейді.\n\nӨңдеуге түпнұсқа кескінді беріп, өзгеретін бөлікті көрсетіңіз. Өндіруші нұсқаулығы элементтер қосуды не алуды, семантикалық маскалауды, стиль көшіруді және референстермен композиция құруды сипаттайды. Пайдалы сұрау түзетуді де, сақталатын шарттарды да атайды: мысалы, тауар пішінін, бетін және жапсырмасын сақтап, фонды өзгерту. Референстерді біріктіргенде әр кірістің нысан келбеті, орта немесе стиль сияқты рөлін белгілеңіз. Нұсқаулық осы нұсқа үшке дейін кіріс кескінімен ең жақсы жұмыс істейтінін айтады; бұл қайшы референстердің шексіз жиынын біріктіруге себеп емес, іс жүзіндегі кеңес.\n\nДиалогтік жетілдіру нақты көрнекі шешімді өзгертіп, сол нысанды сақтай алады. Әр жолы бір байланысты түзетуді сұрап, сол кезекте қолданылған бастапқы кескін мен қабылданған нәтижені сақтаңыз. Не бірізді қалуы және не өзгеруі мүмкін екенін сипаттаңыз. Көрнекі материалдар тізбегінде жаңа оқшау промпт оларды өзі қалпына келтіреді деп болжамай, ортақ нысанды, түстерді және көрнекі ережелерді нақты анықтаңыз. Сақтау нұсқауы сәтті орындалды деп есептемес бұрын түзетілген кескінді референспен салыстырыңыз.\n\nКескін ішіндегі мәтінде нұсқаулық ұсынғандай, алдымен нақты сөздерді бекітіп, кейін сол мәтіні бар суретті сұраңыз. Белгілердің тілін, оқу ретін, орнын және салыстырмалы екпінін айтыңыз. Инфографика сұрауы әр белгі түсіндіретін қатынасты және оны қолдайтын көрнекі элементтерді анықтауы тиіс. Нақты көрсету өлшемінде емлені, тыныс белгілерін және көрнекі байланысты тексеріңіз; оқылатын сияқты жасалған белгі бәрібір есімді, санды немесе көзделген мағынаны өзгерте алады.\n\nМодель картасы осы нұсқа үшін ойлауды, іздеу арқылы негіздеуді, функция шақыруды, код орындауды немесе шектелген құрылымдалған шығысты тізімдемейді. Ол аудио генерациясын не Live API-ді де ұсынбайды. Құжатталған кірісі — мәтін мен кескіндер, сондықтан басқа Gemini модельдерінің аудио, бейне және құжат өңдеу мүмкіндіктерін осы профильге телуге болмайды. Қолданба кәдімгі прозалық жауапта дайын кескін материалы бар деп болжамай, қайтарылған мазмұн бөліктерін нақты өңдеуі керек.\n\nНұсқаулық сұралған кескін саны әрдайым орындалмауы мүмкін екенін және жасалған кескіндерде SynthID белгісі барын айтады. Әр қайтарылған кескінді композицияға, нысан дәлдігіне, нысан санына және нақты сөздерге тексеріңіз. Көріністе бірнеше компонент болса, көзделген орналасуын анық ретпен сипаттап, қажетті келбетті оң тұжырыммен беріңіз. Модельдің нақты атауын, промптты және референстерді нәтижемен бірге сақтаңыз. Бұл көрнекі генерация не өңдеу тапсырмасын тексерілетін етіп, кейінгі түзетуге нақты бастапқы негіз береді.", "editorialOverlay": { "copy_fields": { "practical_html": "Ағылшын тіліндегі техникалық мысал
Change a product photo background\n\nUsing 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.google/gemini-2.5-flash-imageNano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз.
Бұл сипаттама модель мүмкіндіктерін қамтиды. 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 белгісі барын айтады. Әр қайтарылған кескінді композицияға, нысан дәлдігіне, нысан санына және нақты сөздерге тексеріңіз. Көріністе бірнеше компонент болса, көзделген орналасуын анық ретпен сипаттап, қажетті келбетті оң тұжырыммен беріңіз. Модельдің нақты атауын, промптты және референстерді нәтижемен бірге сақтаңыз. Бұл көрнекі генерация не өңдеу тапсырмасын тексерілетін етіп, кейінгі түзетуге нақты бастапқы негіз береді.
POST /v1/chat/completionstexttext| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өріс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 деректерімен бірге жіберіңіз.
Контекст ұзындығы шығыстың жоғарғы шегі емес.
Мәтіндік файл сөзбе-сөз мәтінді бере алады; кіріс суреттері, аудио және файл нысандары дәл байланыстыруды қажет етеді.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Контекст токендерінің саны мынадан көп | Контекст токендерінің саны мынадан аспайды, шегі кіреді | Төлем |
|---|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Контекст токендерінің саны мынадан көп— | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері $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 · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс 0,0006 $ / 1K токен Шығыс · Шығыс 0,06 $ / 1K токен |
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| Баптау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 сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=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."}]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n 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\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n 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\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson немесе 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
/v1/images
google/gemini-2.5-flash-imageNano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз.
Бұл сипаттама модель мүмкіндіктерін қамтиды. 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 белгісі барын айтады. Әр қайтарылған кескінді композицияға, нысан дәлдігіне, нысан санына және нақты сөздерге тексеріңіз. Көріністе бірнеше компонент болса, көзделген орналасуын анық ретпен сипаттап, қажетті келбетті оң тұжырыммен беріңіз. Модельдің нақты атауын, промптты және референстерді нәтижемен бірге сақтаңыз. Бұл көрнекі генерация не өңдеу тапсырмасын тексерілетін етіп, кейінгі түзетуге нақты бастапқы негіз береді.
POST /v1/images/generationstext, imageimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өріс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}
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.24576 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'google/gemini-2.5-flash-image', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n 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"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nҚайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nӘр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.
Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.
Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.
| Өріс | Түрі |
|---|---|
Өрісcreated | Түрі |
Өрісdata[].url | Түрі |
Өрісdata[].b64_json | Түрі |
Өрісusage | Түрі |
Ailoot Ultra google/gemini-2.5-flash-image
/v1/images
google/gemini-2.5-flash-imageNano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз.
Бұл сипаттама модель мүмкіндіктерін қамтиды. 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 белгісі барын айтады. Әр қайтарылған кескінді композицияға, нысан дәлдігіне, нысан санына және нақты сөздерге тексеріңіз. Көріністе бірнеше компонент болса, көзделген орналасуын анық ретпен сипаттап, қажетті келбетті оң тұжырыммен беріңіз. Модельдің нақты атауын, промптты және референстерді нәтижемен бірге сақтаңыз. Бұл көрнекі генерация не өңдеу тапсырмасын тексерілетін етіп, кейінгі түзетуге нақты бастапқы негіз береді.
POST /v1/messagestextjson, sse| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер google/gemini-2.5-flash-image | Әдепкі— |
Өрісmessages | Түріmessage[] | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісmessages[].role | Түріstring | ТалапМіндетті | Мәндер мен шектеулер user, assistant | Әдепкі— |
Өрісmessages[].content | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісmax_tokens | Түріinteger | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісstream | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкіfalse |
Мәтін · UTF-8 мәтіні
messages[].content жолы
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, messages, max_tokens |
Параметрoptional_controls | Параметр талаптарыstream |
Параметрmaterial_types | Параметр талаптарыtext |
Параметрtext_file_material | Параметр талаптарыНақты UTF-8 құжатын оқып, оның мәтінін көрсетілген кіріс жолына немесе хабарлама мазмұнының жолына қойыңыз. |
Өмірлік цикл: synchronous_or_streamed
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Контекст токендерінің саны мынадан көп | Контекст токендерінің саны мынадан аспайды, шегі кіреді | Төлем |
|---|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Контекст токендерінің саны мынадан көп— | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері $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 сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
{\n "model": "google/gemini-2.5-flash-image",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-2.5-flash-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-2.5-flash-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON немесе SSE
Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.
Барлық мазмұн блоктарын, пайымдау қолтаңбаларын және құрал қолданудың нақты ID мәндерін сақтаңыз. SSE блоктарының барлық өзгерістерін жинаңыз; алғашқы мәтіндік блок толық шығыс емес.
Сұрау мен жауаптың ID мәндерін және тақырыптарын сақтаңыз. Мәтіндік тапсырманы алуға арналған ортақ URL берілмеген.
| Өріс | Түрі |
|---|---|
Өрісid | Түріstring |
Өрісmodel | Түріstring |
Өрісcontent[] | Түріtext|thinking|tool_use|other content block |
Өрісstop_reason | Түріstring|null |
Өрісusage | Түріobject |
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қате | Келесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Ailoot Ultra google/gemini-2.5-flash-image
/v1/images
Ағылшын тіліндегі техникалық мысал
Change a product photo background\n\nUsing 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.