Gemini Nano Banana 2.1 — Google компаниясының кескін жасауға және диалог арқылы өңдеуге арналған моделі. Бұл Nano Banana 2 жаңартуы; онда көрнекі шынайылық, нұсқауларды сақтау, мәтінді кескінде беру және кезекті өңдеулердегі кейіпкер бірізділігі жақсартылған. Кіріс кестесіне мәтін, кескіндер, бейне және PDF кіреді, ал шығыс — кескін мен мәтін. Сондықтан ол тауарлық көрініске, инфографикаға немесе бірнеше нақты түзету арқылы дамитын көрнекі серияға пайдалы.
Модель 1K, 2K және 4K шығысты ұсынады, әдепкісі — 1K. Оған Nano Banana 2 моделінің 0.5K нұсқасы берілмеген. Кескін ені мен биіктігінің құжатталған арақатынастарына 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 және 21:9, сондай-ақ биік не панорамалық 1:4, 4:1, 1:8 және 8:1 пішімдері кіреді. Google соңғы кең және биік пішімдерде 2K және 4K кезінде мозаикалау артефактілері түзетілгенін көрсетеді. Ажыратымдылық белгілері бір ғана бекітілген тіктөртбұрышты емес, өлшем санаттарын білдіреді: шаршы 4K кескін — 4096 × 4096, ал құжатталған 16:9 4K шығыс — 5504 × 3072.
Мәтін көрнекі үдерістің елеулі бөлігі. Модель анық оқылатын, стиль берілген мәтінді көрсетуге және инфографика элементтерін дәлірек орналастыруға арналған. Нақты тақырыпты, белгілерді және оқу ретін дайындап, содан кейін сол бекітілген мәтіні бар кескінді сұраңыз. Мәзір, диаграмма немесе нұсқаулық графика үшін жазу мен оның көрнекі элементі арасындағы байланысты атаңыз. Google алдымен мәтінді құрып, содан кейін кескінді сұрауды ұсынады; осылай композиция бекітілген мәтіндік тапсырмадан басталады.
Референстік кескіндерді біріктіру 14-ке дейін кескінді қолдайды. Құжатталған профиль төртке дейін кейіпкердің бірізділігін және онға дейін нысанның дәл сақталуын қамтиды. Әр референске рөл беріңіз: танылатын күйінде қалуы тиіс тауар, кейіпкер келбеті, көзделген фон немесе көрнекі стиль. Тауарға арналған мысал тапсырма: «Бөтелкенің пішіні мен жапсырмасы үшін A кескінін қолдан. Бұйым қойылатын бетті және жарықты беру үшін B кескінін қолдан. Тауарды өзгертпе, оны бүктелген сүлгінің жанына орналастыр және үстінде берілген тақырыпқа бос орын қалдыр».
Google Web Search және Image Search арқылы негіздеу генерацияға өзекті ақпарат пен көрнекі контекст бере алады. Image Search вебтен табылған кескіндерді референс ретінде береді; стандартты веб-негіздеу тақырып туралы ақпарат ұсынады. Бұл фактілік графикаға немесе келбеті нақты нысанға тәуелді көрініске пайдалы. Кескін іздеу үдерісі осы мақсатта адамдардың нақты өмірдегі кескіндерін алуды қолдамайды. Google құжаттаған үдерістегі негізделген жауаптар дереккөз және атрибуция метадеректерін қамтиды, сондықтан қолданба оларды жасалған нәтижемен бірге сақтауы керек.
Ойлауды minimal, medium және high деңгейлерімен баптауға болады; дәл осы модельде әдепкісі — medium. Бұл соңғы шығыстан бұрын композицияны және күрделі нұсқауларды ойластыруға көмектеседі. Кескін нұсқаулығында осы үдерістегі аралық композиция кескіндері сипатталған; олар көзделген соңғы артефакттан бөлек. Промпт сипаттамасы барлық шығыс параметрін өздігінен бекітеді деп күтпей, қажетті соңғы орналасуды, кескін ені мен биіктігінің арақатынасын және ажыратымдылықты анық таңдаңыз.
Диалогтік өңдеу кейінгі сұрауда бар нәтиженің бір бөлігін өзгертуге мүмкіндік береді: композицияның қалғанын сақтап, жарықты реттеу, нысанды жылжыту немесе белгілерді аудару. Алдыңғы кескінді не әрекеттесуді келесі кезекке өткізіп, сұралған өзгерісті де, сақталатын сипаттарды да айтыңыз. Кейіпкерлер сериясында келбет референстерін бірізді сақтап, жаңа ракурс немесе күрделі дене қалпы маңызды болса, дене қалпының референсін қолданыңыз. Іс жүзіндегі түзету тапсырмасы: «Тауарды, белгілерді және орналасуды сақта; тек фонды жылырақ сұр түске өзгерт».
Модель кестесінде кіріс шегі 131,072 токен, шығыс шегі 32,768 токен деп берілген. Кескін жасау мен іздеу арқылы негіздеу қолдау табады; ал аудио жасау, код орындау, функция шақыру, құрылымды шығыс, кэштеу, файл іздеу, URL контексті және Live API осы нұсқада қолдау табатындар ретінде көрсетілмеген. Бейне жасалатын статикалық кескінге ақпарат бере алады; бұл модельді бейне генераторына айналдырмайды. Google кескіндердің нақты санын сұрау сол санды бермеуі мүмкін екенін де айтады. Барлық жасалған кескіндерде SynthID сутаңбасы бар.
Пайдалы алғашқы тапсырма үшін кескіннің мақсатын, нысанын, композициясын, жарығын, камера көрінісін, міндетті мәтінін және шығыс пішінін беріңіз. Мысалы, белгіленген үш қадамы, оқылатын тақырыбы және анықталған түс иерархиясы бар тік инфографика сұрап, келесі өңдеуге дейін мәтін мен өзара орналасуды тексеріңіз. Нәтиже тауар иллюстрациясы, редакциялық графика немесе дизайн референсі бола алады; таңдалған кескінді түсіндірме мәтінімен бірге сақтаңыз.
", "aboutText": "Gemini Nano Banana 2.1 — Google компаниясының кескін жасауға және диалог арқылы өңдеуге арналған моделі. Бұл Nano Banana 2 жаңартуы; онда көрнекі шынайылық, нұсқауларды сақтау, мәтінді кескінде беру және кезекті өңдеулердегі кейіпкер бірізділігі жақсартылған. Кіріс кестесіне мәтін, кескіндер, бейне және PDF кіреді, ал шығыс — кескін мен мәтін. Сондықтан ол тауарлық көрініске, инфографикаға немесе бірнеше нақты түзету арқылы дамитын көрнекі серияға пайдалы.\n\nМодель 1K, 2K және 4K шығысты ұсынады, әдепкісі — 1K. Оған Nano Banana 2 моделінің 0.5K нұсқасы берілмеген. Кескін ені мен биіктігінің құжатталған арақатынастарына 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 және 21:9, сондай-ақ биік не панорамалық 1:4, 4:1, 1:8 және 8:1 пішімдері кіреді. Google соңғы кең және биік пішімдерде 2K және 4K кезінде мозаикалау артефактілері түзетілгенін көрсетеді. Ажыратымдылық белгілері бір ғана бекітілген тіктөртбұрышты емес, өлшем санаттарын білдіреді: шаршы 4K кескін — 4096 × 4096, ал құжатталған 16:9 4K шығыс — 5504 × 3072.\n\nМәтін көрнекі үдерістің елеулі бөлігі. Модель анық оқылатын, стиль берілген мәтінді көрсетуге және инфографика элементтерін дәлірек орналастыруға арналған. Нақты тақырыпты, белгілерді және оқу ретін дайындап, содан кейін сол бекітілген мәтіні бар кескінді сұраңыз. Мәзір, диаграмма немесе нұсқаулық графика үшін жазу мен оның көрнекі элементі арасындағы байланысты атаңыз. Google алдымен мәтінді құрып, содан кейін кескінді сұрауды ұсынады; осылай композиция бекітілген мәтіндік тапсырмадан басталады.\n\nРеференстік кескіндерді біріктіру 14-ке дейін кескінді қолдайды. Құжатталған профиль төртке дейін кейіпкердің бірізділігін және онға дейін нысанның дәл сақталуын қамтиды. Әр референске рөл беріңіз: танылатын күйінде қалуы тиіс тауар, кейіпкер келбеті, көзделген фон немесе көрнекі стиль. Тауарға арналған мысал тапсырма: «Бөтелкенің пішіні мен жапсырмасы үшін A кескінін қолдан. Бұйым қойылатын бетті және жарықты беру үшін B кескінін қолдан. Тауарды өзгертпе, оны бүктелген сүлгінің жанына орналастыр және үстінде берілген тақырыпқа бос орын қалдыр».\n\nGoogle Web Search және Image Search арқылы негіздеу генерацияға өзекті ақпарат пен көрнекі контекст бере алады. Image Search вебтен табылған кескіндерді референс ретінде береді; стандартты веб-негіздеу тақырып туралы ақпарат ұсынады. Бұл фактілік графикаға немесе келбеті нақты нысанға тәуелді көрініске пайдалы. Кескін іздеу үдерісі осы мақсатта адамдардың нақты өмірдегі кескіндерін алуды қолдамайды. Google құжаттаған үдерістегі негізделген жауаптар дереккөз және атрибуция метадеректерін қамтиды, сондықтан қолданба оларды жасалған нәтижемен бірге сақтауы керек.\n\nОйлауды minimal, medium және high деңгейлерімен баптауға болады; дәл осы модельде әдепкісі — medium. Бұл соңғы шығыстан бұрын композицияны және күрделі нұсқауларды ойластыруға көмектеседі. Кескін нұсқаулығында осы үдерістегі аралық композиция кескіндері сипатталған; олар көзделген соңғы артефакттан бөлек. Промпт сипаттамасы барлық шығыс параметрін өздігінен бекітеді деп күтпей, қажетті соңғы орналасуды, кескін ені мен биіктігінің арақатынасын және ажыратымдылықты анық таңдаңыз.\n\nДиалогтік өңдеу кейінгі сұрауда бар нәтиженің бір бөлігін өзгертуге мүмкіндік береді: композицияның қалғанын сақтап, жарықты реттеу, нысанды жылжыту немесе белгілерді аудару. Алдыңғы кескінді не әрекеттесуді келесі кезекке өткізіп, сұралған өзгерісті де, сақталатын сипаттарды да айтыңыз. Кейіпкерлер сериясында келбет референстерін бірізді сақтап, жаңа ракурс немесе күрделі дене қалпы маңызды болса, дене қалпының референсін қолданыңыз. Іс жүзіндегі түзету тапсырмасы: «Тауарды, белгілерді және орналасуды сақта; тек фонды жылырақ сұр түске өзгерт».\n\nМодель кестесінде кіріс шегі 131,072 токен, шығыс шегі 32,768 токен деп берілген. Кескін жасау мен іздеу арқылы негіздеу қолдау табады; ал аудио жасау, код орындау, функция шақыру, құрылымды шығыс, кэштеу, файл іздеу, URL контексті және Live API осы нұсқада қолдау табатындар ретінде көрсетілмеген. Бейне жасалатын статикалық кескінге ақпарат бере алады; бұл модельді бейне генераторына айналдырмайды. Google кескіндердің нақты санын сұрау сол санды бермеуі мүмкін екенін де айтады. Барлық жасалған кескіндерде SynthID сутаңбасы бар.\n\nПайдалы алғашқы тапсырма үшін кескіннің мақсатын, нысанын, композициясын, жарығын, камера көрінісін, міндетті мәтінін және шығыс пішінін беріңіз. Мысалы, белгіленген үш қадамы, оқылатын тақырыбы және анықталған түс иерархиясы бар тік инфографика сұрап, келесі өңдеуге дейін мәтін мен өзара орналасуды тексеріңіз. Нәтиже тауар иллюстрациясы, редакциялық графика немесе дизайн референсі бола алады; таңдалған кескінді түсіндірме мәтінімен бірге сақтаңыз.", "editorialOverlay": { "copy_fields": { "practical_html": "Ағылшын тіліндегі техникалық мысал
Refine an approved poster background\n\nEdit the supplied event poster. Preserve every word, the headline hierarchy, illustration placement and portrait composition. Change only the background from cool white to warm ivory, keeping dark text readable and retaining the original accent color. Do not add shapes, badges, textures or extra captions. Return the revised poster image.One edited poster with the original wording and layout preserved over a warm ivory background.Compare every word and element position against the supplied poster, then inspect text contrast.google/gemini-nano-banana-2.1Gemini Nano Banana 2.1 мәтін мен көрнекі материалдан диалог арқылы кескіндер жасайды және өңдейді. Ол мәтіннің кескінде берілуін, инфографика элементтерінің орналасуын және диалогтың бірнеше қадамындағы бірізділікті жақсартады; нақты көрнекі тапсырма үшін 1K–4K шығыс пен 14-ке дейін референстік кескінді ұсынады.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Gemini Nano Banana 2.1 — Google компаниясының кескін жасауға және диалог арқылы өңдеуге арналған моделі. Бұл Nano Banana 2 жаңартуы; онда көрнекі шынайылық, нұсқауларды сақтау, мәтінді кескінде беру және кезекті өңдеулердегі кейіпкер бірізділігі жақсартылған. Кіріс кестесіне мәтін, кескіндер, бейне және PDF кіреді, ал шығыс — кескін мен мәтін. Сондықтан ол тауарлық көрініске, инфографикаға немесе бірнеше нақты түзету арқылы дамитын көрнекі серияға пайдалы.
Модель 1K, 2K және 4K шығысты ұсынады, әдепкісі — 1K. Оған Nano Banana 2 моделінің 0.5K нұсқасы берілмеген. Кескін ені мен биіктігінің құжатталған арақатынастарына 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 және 21:9, сондай-ақ биік не панорамалық 1:4, 4:1, 1:8 және 8:1 пішімдері кіреді. Google соңғы кең және биік пішімдерде 2K және 4K кезінде мозаикалау артефактілері түзетілгенін көрсетеді. Ажыратымдылық белгілері бір ғана бекітілген тіктөртбұрышты емес, өлшем санаттарын білдіреді: шаршы 4K кескін — 4096 × 4096, ал құжатталған 16:9 4K шығыс — 5504 × 3072.
Мәтін көрнекі үдерістің елеулі бөлігі. Модель анық оқылатын, стиль берілген мәтінді көрсетуге және инфографика элементтерін дәлірек орналастыруға арналған. Нақты тақырыпты, белгілерді және оқу ретін дайындап, содан кейін сол бекітілген мәтіні бар кескінді сұраңыз. Мәзір, диаграмма немесе нұсқаулық графика үшін жазу мен оның көрнекі элементі арасындағы байланысты атаңыз. Google алдымен мәтінді құрып, содан кейін кескінді сұрауды ұсынады; осылай композиция бекітілген мәтіндік тапсырмадан басталады.
Референстік кескіндерді біріктіру 14-ке дейін кескінді қолдайды. Құжатталған профиль төртке дейін кейіпкердің бірізділігін және онға дейін нысанның дәл сақталуын қамтиды. Әр референске рөл беріңіз: танылатын күйінде қалуы тиіс тауар, кейіпкер келбеті, көзделген фон немесе көрнекі стиль. Тауарға арналған мысал тапсырма: «Бөтелкенің пішіні мен жапсырмасы үшін A кескінін қолдан. Бұйым қойылатын бетті және жарықты беру үшін B кескінін қолдан. Тауарды өзгертпе, оны бүктелген сүлгінің жанына орналастыр және үстінде берілген тақырыпқа бос орын қалдыр».
Google Web Search және Image Search арқылы негіздеу генерацияға өзекті ақпарат пен көрнекі контекст бере алады. Image Search вебтен табылған кескіндерді референс ретінде береді; стандартты веб-негіздеу тақырып туралы ақпарат ұсынады. Бұл фактілік графикаға немесе келбеті нақты нысанға тәуелді көрініске пайдалы. Кескін іздеу үдерісі осы мақсатта адамдардың нақты өмірдегі кескіндерін алуды қолдамайды. Google құжаттаған үдерістегі негізделген жауаптар дереккөз және атрибуция метадеректерін қамтиды, сондықтан қолданба оларды жасалған нәтижемен бірге сақтауы керек.
Ойлауды minimal, medium және high деңгейлерімен баптауға болады; дәл осы модельде әдепкісі — medium. Бұл соңғы шығыстан бұрын композицияны және күрделі нұсқауларды ойластыруға көмектеседі. Кескін нұсқаулығында осы үдерістегі аралық композиция кескіндері сипатталған; олар көзделген соңғы артефакттан бөлек. Промпт сипаттамасы барлық шығыс параметрін өздігінен бекітеді деп күтпей, қажетті соңғы орналасуды, кескін ені мен биіктігінің арақатынасын және ажыратымдылықты анық таңдаңыз.
Диалогтік өңдеу кейінгі сұрауда бар нәтиженің бір бөлігін өзгертуге мүмкіндік береді: композицияның қалғанын сақтап, жарықты реттеу, нысанды жылжыту немесе белгілерді аудару. Алдыңғы кескінді не әрекеттесуді келесі кезекке өткізіп, сұралған өзгерісті де, сақталатын сипаттарды да айтыңыз. Кейіпкерлер сериясында келбет референстерін бірізді сақтап, жаңа ракурс немесе күрделі дене қалпы маңызды болса, дене қалпының референсін қолданыңыз. Іс жүзіндегі түзету тапсырмасы: «Тауарды, белгілерді және орналасуды сақта; тек фонды жылырақ сұр түске өзгерт».
Модель кестесінде кіріс шегі 131,072 токен, шығыс шегі 32,768 токен деп берілген. Кескін жасау мен іздеу арқылы негіздеу қолдау табады; ал аудио жасау, код орындау, функция шақыру, құрылымды шығыс, кэштеу, файл іздеу, URL контексті және Live API осы нұсқада қолдау табатындар ретінде көрсетілмеген. Бейне жасалатын статикалық кескінге ақпарат бере алады; бұл модельді бейне генераторына айналдырмайды. Google кескіндердің нақты санын сұрау сол санды бермеуі мүмкін екенін де айтады. Барлық жасалған кескіндерде SynthID сутаңбасы бар.
Пайдалы алғашқы тапсырма үшін кескіннің мақсатын, нысанын, композициясын, жарығын, камера көрінісін, міндетті мәтінін және шығыс пішінін беріңіз. Мысалы, белгіленген үш қадамы, оқылатын тақырыбы және анықталған түс иерархиясы бар тік инфографика сұрап, келесі өңдеуге дейін мәтін мен өзара орналасуды тексеріңіз. Нәтиже тауар иллюстрациясы, редакциялық графика немесе дизайн референсі бола алады; таңдалған кескінді түсіндірме мәтінімен бірге сақтаңыз.
POST /v1/chat/completionstexttext| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер google/gemini-nano-banana-2.1 | Әдепкі— |
Өріс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.003 / 1K токен Шығыс · Шығыс токендері $0.015 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен Шығыс · Шығыс кескін токендері $0.06 / 1K сурет токені |
| БаптауСұрау ұзындығының 1-деңгейі | Мөлшерлемелер кестесі— | Контекст токендерінің саны мынадан көп0 | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері $0.003 / 1K токен Шығыс · Шығыс токендері $0.015 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен |
Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.
| Баптау | Төлемді есептеу шарттары | Төлем |
|---|---|---|
| БаптауGoogle: Nano Banana 2.1 · Әдепкі конфигурация | Төлемді есептеу шарттарыӘдепкі баптау | Төлем Кіріс · Кіріс токендері 0,003 $ / 1K токен Шығыс · Шығыс токендері 0,015 $ / 1K токен Шығыс · Шығыс кескін 0,06 $ / 1K токен Шығыс · Веб-іздеу 0,028 $ әр іздеу үшін |
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-nano-banana-2.1", "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-nano-banana-2.1',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-nano-banana-2.1',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-nano-banana-2.1
/v1/images
google/gemini-nano-banana-2.1Gemini Nano Banana 2.1 мәтін мен көрнекі материалдан диалог арқылы кескіндер жасайды және өңдейді. Ол мәтіннің кескінде берілуін, инфографика элементтерінің орналасуын және диалогтың бірнеше қадамындағы бірізділікті жақсартады; нақты көрнекі тапсырма үшін 1K–4K шығыс пен 14-ке дейін референстік кескінді ұсынады.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Gemini Nano Banana 2.1 — Google компаниясының кескін жасауға және диалог арқылы өңдеуге арналған моделі. Бұл Nano Banana 2 жаңартуы; онда көрнекі шынайылық, нұсқауларды сақтау, мәтінді кескінде беру және кезекті өңдеулердегі кейіпкер бірізділігі жақсартылған. Кіріс кестесіне мәтін, кескіндер, бейне және PDF кіреді, ал шығыс — кескін мен мәтін. Сондықтан ол тауарлық көрініске, инфографикаға немесе бірнеше нақты түзету арқылы дамитын көрнекі серияға пайдалы.
Модель 1K, 2K және 4K шығысты ұсынады, әдепкісі — 1K. Оған Nano Banana 2 моделінің 0.5K нұсқасы берілмеген. Кескін ені мен биіктігінің құжатталған арақатынастарына 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 және 21:9, сондай-ақ биік не панорамалық 1:4, 4:1, 1:8 және 8:1 пішімдері кіреді. Google соңғы кең және биік пішімдерде 2K және 4K кезінде мозаикалау артефактілері түзетілгенін көрсетеді. Ажыратымдылық белгілері бір ғана бекітілген тіктөртбұрышты емес, өлшем санаттарын білдіреді: шаршы 4K кескін — 4096 × 4096, ал құжатталған 16:9 4K шығыс — 5504 × 3072.
Мәтін көрнекі үдерістің елеулі бөлігі. Модель анық оқылатын, стиль берілген мәтінді көрсетуге және инфографика элементтерін дәлірек орналастыруға арналған. Нақты тақырыпты, белгілерді және оқу ретін дайындап, содан кейін сол бекітілген мәтіні бар кескінді сұраңыз. Мәзір, диаграмма немесе нұсқаулық графика үшін жазу мен оның көрнекі элементі арасындағы байланысты атаңыз. Google алдымен мәтінді құрып, содан кейін кескінді сұрауды ұсынады; осылай композиция бекітілген мәтіндік тапсырмадан басталады.
Референстік кескіндерді біріктіру 14-ке дейін кескінді қолдайды. Құжатталған профиль төртке дейін кейіпкердің бірізділігін және онға дейін нысанның дәл сақталуын қамтиды. Әр референске рөл беріңіз: танылатын күйінде қалуы тиіс тауар, кейіпкер келбеті, көзделген фон немесе көрнекі стиль. Тауарға арналған мысал тапсырма: «Бөтелкенің пішіні мен жапсырмасы үшін A кескінін қолдан. Бұйым қойылатын бетті және жарықты беру үшін B кескінін қолдан. Тауарды өзгертпе, оны бүктелген сүлгінің жанына орналастыр және үстінде берілген тақырыпқа бос орын қалдыр».
Google Web Search және Image Search арқылы негіздеу генерацияға өзекті ақпарат пен көрнекі контекст бере алады. Image Search вебтен табылған кескіндерді референс ретінде береді; стандартты веб-негіздеу тақырып туралы ақпарат ұсынады. Бұл фактілік графикаға немесе келбеті нақты нысанға тәуелді көрініске пайдалы. Кескін іздеу үдерісі осы мақсатта адамдардың нақты өмірдегі кескіндерін алуды қолдамайды. Google құжаттаған үдерістегі негізделген жауаптар дереккөз және атрибуция метадеректерін қамтиды, сондықтан қолданба оларды жасалған нәтижемен бірге сақтауы керек.
Ойлауды minimal, medium және high деңгейлерімен баптауға болады; дәл осы модельде әдепкісі — medium. Бұл соңғы шығыстан бұрын композицияны және күрделі нұсқауларды ойластыруға көмектеседі. Кескін нұсқаулығында осы үдерістегі аралық композиция кескіндері сипатталған; олар көзделген соңғы артефакттан бөлек. Промпт сипаттамасы барлық шығыс параметрін өздігінен бекітеді деп күтпей, қажетті соңғы орналасуды, кескін ені мен биіктігінің арақатынасын және ажыратымдылықты анық таңдаңыз.
Диалогтік өңдеу кейінгі сұрауда бар нәтиженің бір бөлігін өзгертуге мүмкіндік береді: композицияның қалғанын сақтап, жарықты реттеу, нысанды жылжыту немесе белгілерді аудару. Алдыңғы кескінді не әрекеттесуді келесі кезекке өткізіп, сұралған өзгерісті де, сақталатын сипаттарды да айтыңыз. Кейіпкерлер сериясында келбет референстерін бірізді сақтап, жаңа ракурс немесе күрделі дене қалпы маңызды болса, дене қалпының референсін қолданыңыз. Іс жүзіндегі түзету тапсырмасы: «Тауарды, белгілерді және орналасуды сақта; тек фонды жылырақ сұр түске өзгерт».
Модель кестесінде кіріс шегі 131,072 токен, шығыс шегі 32,768 токен деп берілген. Кескін жасау мен іздеу арқылы негіздеу қолдау табады; ал аудио жасау, код орындау, функция шақыру, құрылымды шығыс, кэштеу, файл іздеу, URL контексті және Live API осы нұсқада қолдау табатындар ретінде көрсетілмеген. Бейне жасалатын статикалық кескінге ақпарат бере алады; бұл модельді бейне генераторына айналдырмайды. Google кескіндердің нақты санын сұрау сол санды бермеуі мүмкін екенін де айтады. Барлық жасалған кескіндерде SynthID сутаңбасы бар.
Пайдалы алғашқы тапсырма үшін кескіннің мақсатын, нысанын, композициясын, жарығын, камера көрінісін, міндетті мәтінін және шығыс пішінін беріңіз. Мысалы, белгіленген үш қадамы, оқылатын тақырыбы және анықталған түс иерархиясы бар тік инфографика сұрап, келесі өңдеуге дейін мәтін мен өзара орналасуды тексеріңіз. Нәтиже тауар иллюстрациясы, редакциялық графика немесе дизайн референсі бола алады; таңдалған кескінді түсіндірме мәтінімен бірге сақтаңыз.
POST /v1/images/generationstext, imageimage| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер google/gemini-nano-banana-2.1 | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 1K, 2K, 4K | Әдепкі— |
Өрісaspect_ratio | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 | Әдепкі— |
Өрісn | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 Ең көбі: 1 | Әдепкі— |
Өрісinput_references | Түріarray | ТалапМіндетті емес | Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 14 | Әдепкі— |
Өріс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-nano-banana-2.1', '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-nano-banana-2.1
/v1/images
google/gemini-nano-banana-2.1Gemini Nano Banana 2.1 мәтін мен көрнекі материалдан диалог арқылы кескіндер жасайды және өңдейді. Ол мәтіннің кескінде берілуін, инфографика элементтерінің орналасуын және диалогтың бірнеше қадамындағы бірізділікті жақсартады; нақты көрнекі тапсырма үшін 1K–4K шығыс пен 14-ке дейін референстік кескінді ұсынады.
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Gemini Nano Banana 2.1 — Google компаниясының кескін жасауға және диалог арқылы өңдеуге арналған моделі. Бұл Nano Banana 2 жаңартуы; онда көрнекі шынайылық, нұсқауларды сақтау, мәтінді кескінде беру және кезекті өңдеулердегі кейіпкер бірізділігі жақсартылған. Кіріс кестесіне мәтін, кескіндер, бейне және PDF кіреді, ал шығыс — кескін мен мәтін. Сондықтан ол тауарлық көрініске, инфографикаға немесе бірнеше нақты түзету арқылы дамитын көрнекі серияға пайдалы.
Модель 1K, 2K және 4K шығысты ұсынады, әдепкісі — 1K. Оған Nano Banana 2 моделінің 0.5K нұсқасы берілмеген. Кескін ені мен биіктігінің құжатталған арақатынастарына 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 және 21:9, сондай-ақ биік не панорамалық 1:4, 4:1, 1:8 және 8:1 пішімдері кіреді. Google соңғы кең және биік пішімдерде 2K және 4K кезінде мозаикалау артефактілері түзетілгенін көрсетеді. Ажыратымдылық белгілері бір ғана бекітілген тіктөртбұрышты емес, өлшем санаттарын білдіреді: шаршы 4K кескін — 4096 × 4096, ал құжатталған 16:9 4K шығыс — 5504 × 3072.
Мәтін көрнекі үдерістің елеулі бөлігі. Модель анық оқылатын, стиль берілген мәтінді көрсетуге және инфографика элементтерін дәлірек орналастыруға арналған. Нақты тақырыпты, белгілерді және оқу ретін дайындап, содан кейін сол бекітілген мәтіні бар кескінді сұраңыз. Мәзір, диаграмма немесе нұсқаулық графика үшін жазу мен оның көрнекі элементі арасындағы байланысты атаңыз. Google алдымен мәтінді құрып, содан кейін кескінді сұрауды ұсынады; осылай композиция бекітілген мәтіндік тапсырмадан басталады.
Референстік кескіндерді біріктіру 14-ке дейін кескінді қолдайды. Құжатталған профиль төртке дейін кейіпкердің бірізділігін және онға дейін нысанның дәл сақталуын қамтиды. Әр референске рөл беріңіз: танылатын күйінде қалуы тиіс тауар, кейіпкер келбеті, көзделген фон немесе көрнекі стиль. Тауарға арналған мысал тапсырма: «Бөтелкенің пішіні мен жапсырмасы үшін A кескінін қолдан. Бұйым қойылатын бетті және жарықты беру үшін B кескінін қолдан. Тауарды өзгертпе, оны бүктелген сүлгінің жанына орналастыр және үстінде берілген тақырыпқа бос орын қалдыр».
Google Web Search және Image Search арқылы негіздеу генерацияға өзекті ақпарат пен көрнекі контекст бере алады. Image Search вебтен табылған кескіндерді референс ретінде береді; стандартты веб-негіздеу тақырып туралы ақпарат ұсынады. Бұл фактілік графикаға немесе келбеті нақты нысанға тәуелді көрініске пайдалы. Кескін іздеу үдерісі осы мақсатта адамдардың нақты өмірдегі кескіндерін алуды қолдамайды. Google құжаттаған үдерістегі негізделген жауаптар дереккөз және атрибуция метадеректерін қамтиды, сондықтан қолданба оларды жасалған нәтижемен бірге сақтауы керек.
Ойлауды minimal, medium және high деңгейлерімен баптауға болады; дәл осы модельде әдепкісі — medium. Бұл соңғы шығыстан бұрын композицияны және күрделі нұсқауларды ойластыруға көмектеседі. Кескін нұсқаулығында осы үдерістегі аралық композиция кескіндері сипатталған; олар көзделген соңғы артефакттан бөлек. Промпт сипаттамасы барлық шығыс параметрін өздігінен бекітеді деп күтпей, қажетті соңғы орналасуды, кескін ені мен биіктігінің арақатынасын және ажыратымдылықты анық таңдаңыз.
Диалогтік өңдеу кейінгі сұрауда бар нәтиженің бір бөлігін өзгертуге мүмкіндік береді: композицияның қалғанын сақтап, жарықты реттеу, нысанды жылжыту немесе белгілерді аудару. Алдыңғы кескінді не әрекеттесуді келесі кезекке өткізіп, сұралған өзгерісті де, сақталатын сипаттарды да айтыңыз. Кейіпкерлер сериясында келбет референстерін бірізді сақтап, жаңа ракурс немесе күрделі дене қалпы маңызды болса, дене қалпының референсін қолданыңыз. Іс жүзіндегі түзету тапсырмасы: «Тауарды, белгілерді және орналасуды сақта; тек фонды жылырақ сұр түске өзгерт».
Модель кестесінде кіріс шегі 131,072 токен, шығыс шегі 32,768 токен деп берілген. Кескін жасау мен іздеу арқылы негіздеу қолдау табады; ал аудио жасау, код орындау, функция шақыру, құрылымды шығыс, кэштеу, файл іздеу, URL контексті және Live API осы нұсқада қолдау табатындар ретінде көрсетілмеген. Бейне жасалатын статикалық кескінге ақпарат бере алады; бұл модельді бейне генераторына айналдырмайды. Google кескіндердің нақты санын сұрау сол санды бермеуі мүмкін екенін де айтады. Барлық жасалған кескіндерде SynthID сутаңбасы бар.
Пайдалы алғашқы тапсырма үшін кескіннің мақсатын, нысанын, композициясын, жарығын, камера көрінісін, міндетті мәтінін және шығыс пішінін беріңіз. Мысалы, белгіленген үш қадамы, оқылатын тақырыбы және анықталған түс иерархиясы бар тік инфографика сұрап, келесі өңдеуге дейін мәтін мен өзара орналасуды тексеріңіз. Нәтиже тауар иллюстрациясы, редакциялық графика немесе дизайн референсі бола алады; таңдалған кескінді түсіндірме мәтінімен бірге сақтаңыз.
POST /v1/messagestextjson, sse| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер google/gemini-nano-banana-2.1 | Әдепкі— |
Өріс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.003 / 1K токен Шығыс · Шығыс токендері $0.015 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен Шығыс · Шығыс кескін токендері $0.06 / 1K сурет токені |
| БаптауСұрау ұзындығының 1-деңгейі | Мөлшерлемелер кестесі— | Контекст токендерінің саны мынадан көп0 | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері $0.003 / 1K токен Шығыс · Шығыс токендері $0.015 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
{\n "model": "google/gemini-nano-banana-2.1",\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-nano-banana-2.1', '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-nano-banana-2.1', '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-nano-banana-2.1
/v1/images
Ағылшын тіліндегі техникалық мысал
Refine an approved poster background\n\nEdit the supplied event poster. Preserve every word, the headline hierarchy, illustration placement and portrait composition. Change only the background from cool white to warm ivory, keeping dark text readable and retaining the original accent color. Do not add shapes, badges, textures or extra captions. Return the revised poster image.One edited poster with the original wording and layout preserved over a warm ivory background.Compare every word and element position against the supplied poster, then inspect text contrast.