Gemini 2.5 Flash Image, shuningdek Nano Banana nomi bilan tanilgan model — Google’ning vizual yaratish va suhbat davomida tasvir tahrirlash uchun matn va tasvir modeli. U ixtiyoriy tasvir namunalari bilan birga ko‘rsatmani qabul qiladi va hamroh matn bilan tasvirlar qaytarishi mumkin. Aynan shu 2.5 Flash Image nashri Nano Banana 2, Nano Banana Pro va keyingi Lite tasvir modellaridan farq qiladi. Uning foydali natijasi umumiy Gemini 2.5 matn modelining javobi emas, yaratilgan yoki tahrirlangan vizual materialdir.
Aynan shu model kartasida 65,536 kirish tokeni va 32,768 chiqish tokeni ko‘rsatilgan. Tasvirlar va ko‘rsatmalar kirishning, qaytgan tasvir yoki matn esa natijaning bir qismidir. Qo‘llanmaning aniqlik jadvalida qo‘llab-quvvatlanadigan tomonlar nisbatlari orasida 1:1 chiqish uchun 1024×1024, 3:4 uchun 864×1184 va 16:9 uchun 1344×768 keltirilgan. Sahnani loyihalashdan oldin mo‘ljallangan ko‘rsatish shaklini tanlang. Keyingi Gemini tasvir nashrining yuqori aniqlik variantlarini aynan shu model uchun hujjatlashtirilgan boshqaruvlar deb hisoblash kerak emas.
Matndan tasvir yaratish uchun asosiy obyekt, harakat, muhit, uslub, yoritish va ko‘rish nuqtasini ko‘rsating. Mahsulot illyustratsiyasi taqdim etilgan vizual uslubdan foydalanib, mos muhitda yaqqol ko‘rinadigan material tafsilotini so‘rashi mumkin. Model asosiy obyekt va har qanday matn uchun joy ajrata olishi uchun rasmning maqsadini tushuntiring. Yaqin ko‘rinish, yuqoridan kompozitsiya yoki past rakurs kabi fotografik tavsiflar bir-biriga aloqasiz uslub so‘zlari ro‘yxatidan ko‘ra kadrni aniqroq belgilashga yordam beradi.
Tahrir uchun asl tasvirni bering va o‘zgartiriladigan qismni belgilang. Yaratuvchi qo‘llanmasida elementlarni qo‘shish yoki olib tashlash, semantik niqoblash, uslubni ko‘chirish va namunalar yordamida kompozitsiya tuzish tasvirlangan. Foydali so‘rov tahrirni ham, saqlanadigan shartlarni ham aytadi — masalan, mahsulot shakli, sirti va yorlig‘ini saqlab, fonni o‘zgartirish. Namunalarni birlashtirganda har bir kirishning vazifasini, masalan, obyekt tashqi ko‘rinishi, muhit yoki uslubni belgilang. Qo‘llanma bu nashr uchtagacha kiruvchi tasvir bilan eng yaxshi ishlashini aytadi; bu amaliy tavsiya bo‘lib, bir-biriga zid namunalarning cheksiz to‘plamini birlashtirish uchun asos emas.
Suhbat davomida takomillashtirish muayyan vizual qarorni o‘zgartirgan holda bir xil obyektni saqlashi mumkin. Har safar bitta bog‘liq tahrirni so‘rang va shu suhbat navbatida ishlatilgan manba tasviri hamda qabul qilingan natijani saqlang. Nimalar izchil qolishi va nimalar o‘zgarishi mumkinligini tasvirlang. Materiallar turkumi uchun yangi ajratilgan prompt ularni qayta tiklaydi deb taxmin qilish o‘rniga, umumiy obyekt, ranglar va vizual qoidalarni aniq belgilang. Saqlash ko‘rsatmasi muvaffaqiyatli bajarildi deb hisoblashdan oldin tahrirlangan tasvirni namuna bilan solishtiring.
Tasvir ichidagi matn uchun qo‘llanma tavsiya qilganidek, avval aniq matnni yakunlang, keyin shu matnni o‘z ichiga olgan rasmni so‘rang. Yozuvlarning tili, o‘qish tartibi, joylashuvi va nisbiy urg‘usini ko‘rsating. Infografika so‘rovi har bir yozuv qaysi munosabatni tushuntirishini va uni qaysi vizual elementlar asoslashini aniqlashi kerak. Imlo, tinish belgilari va vizual bog‘lanishni haqiqiy ko‘rsatish o‘lchamida tekshiring; o‘qiladigandek ko‘ringan yaratilgan yozuv baribir nom, son yoki ko‘zlangan ma’noni o‘zgartirishi mumkin.
Model kartasida ushbu nashr uchun fikrlash, qidiruv manbalari bilan asoslash, funksiya chaqirish, kod bajarish yoki sxema bilan cheklangan tuzilgan chiqish keltirilmagan. Shuningdek, u audio yaratish yoki Live API’ni e’lon qilmaydi. Uning hujjatlashtirilgan kirishi matn va tasvirlardir, shuning uchun boshqa Gemini modellaridagi audio, video va hujjat qayta ishlash xususiyatlarini ushbu profilga qo‘shish kerak emas. Ilova odatiy nasriy javob ichida tayyor tasvir materiali bor deb taxmin qilish o‘rniga, qaytgan mazmun qismlarini aniq qayta ishlashi lozim.
Qo‘llanma so‘ralgan tasvirlar soniga har doim ham rioya qilinmasligini va yaratilgan tasvirlarda SynthID belgisi borligini qayd etadi. Har bir qaytgan tasvirni kompozitsiya, obyektga moslik, obyektlar soni va aniq matn bo‘yicha tekshiring. Sahna bir nechta tarkibiy qismga ega bo‘lsa, ularning kerakli joylashuvini aniq tartibda tavsiflang va ko‘zlangan ko‘rinishni ijobiy shaklda ifodalang. Natija bilan birga aniq model identifikatori, prompt va namunalarni saqlang. Bu vizual yaratish yoki tahrirlash vazifasini tekshirishga yaroqli qiladi va keyingi tahrir uchun aniq boshlang‘ich nuqta beradi.
", "aboutText": "Gemini 2.5 Flash Image, shuningdek Nano Banana nomi bilan tanilgan model — Google’ning vizual yaratish va suhbat davomida tasvir tahrirlash uchun matn va tasvir modeli. U ixtiyoriy tasvir namunalari bilan birga ko‘rsatmani qabul qiladi va hamroh matn bilan tasvirlar qaytarishi mumkin. Aynan shu 2.5 Flash Image nashri Nano Banana 2, Nano Banana Pro va keyingi Lite tasvir modellaridan farq qiladi. Uning foydali natijasi umumiy Gemini 2.5 matn modelining javobi emas, yaratilgan yoki tahrirlangan vizual materialdir.\n\nAynan shu model kartasida 65,536 kirish tokeni va 32,768 chiqish tokeni ko‘rsatilgan. Tasvirlar va ko‘rsatmalar kirishning, qaytgan tasvir yoki matn esa natijaning bir qismidir. Qo‘llanmaning aniqlik jadvalida qo‘llab-quvvatlanadigan tomonlar nisbatlari orasida 1:1 chiqish uchun 1024×1024, 3:4 uchun 864×1184 va 16:9 uchun 1344×768 keltirilgan. Sahnani loyihalashdan oldin mo‘ljallangan ko‘rsatish shaklini tanlang. Keyingi Gemini tasvir nashrining yuqori aniqlik variantlarini aynan shu model uchun hujjatlashtirilgan boshqaruvlar deb hisoblash kerak emas.\n\nMatndan tasvir yaratish uchun asosiy obyekt, harakat, muhit, uslub, yoritish va ko‘rish nuqtasini ko‘rsating. Mahsulot illyustratsiyasi taqdim etilgan vizual uslubdan foydalanib, mos muhitda yaqqol ko‘rinadigan material tafsilotini so‘rashi mumkin. Model asosiy obyekt va har qanday matn uchun joy ajrata olishi uchun rasmning maqsadini tushuntiring. Yaqin ko‘rinish, yuqoridan kompozitsiya yoki past rakurs kabi fotografik tavsiflar bir-biriga aloqasiz uslub so‘zlari ro‘yxatidan ko‘ra kadrni aniqroq belgilashga yordam beradi.\n\nTahrir uchun asl tasvirni bering va o‘zgartiriladigan qismni belgilang. Yaratuvchi qo‘llanmasida elementlarni qo‘shish yoki olib tashlash, semantik niqoblash, uslubni ko‘chirish va namunalar yordamida kompozitsiya tuzish tasvirlangan. Foydali so‘rov tahrirni ham, saqlanadigan shartlarni ham aytadi — masalan, mahsulot shakli, sirti va yorlig‘ini saqlab, fonni o‘zgartirish. Namunalarni birlashtirganda har bir kirishning vazifasini, masalan, obyekt tashqi ko‘rinishi, muhit yoki uslubni belgilang. Qo‘llanma bu nashr uchtagacha kiruvchi tasvir bilan eng yaxshi ishlashini aytadi; bu amaliy tavsiya bo‘lib, bir-biriga zid namunalarning cheksiz to‘plamini birlashtirish uchun asos emas.\n\nSuhbat davomida takomillashtirish muayyan vizual qarorni o‘zgartirgan holda bir xil obyektni saqlashi mumkin. Har safar bitta bog‘liq tahrirni so‘rang va shu suhbat navbatida ishlatilgan manba tasviri hamda qabul qilingan natijani saqlang. Nimalar izchil qolishi va nimalar o‘zgarishi mumkinligini tasvirlang. Materiallar turkumi uchun yangi ajratilgan prompt ularni qayta tiklaydi deb taxmin qilish o‘rniga, umumiy obyekt, ranglar va vizual qoidalarni aniq belgilang. Saqlash ko‘rsatmasi muvaffaqiyatli bajarildi deb hisoblashdan oldin tahrirlangan tasvirni namuna bilan solishtiring.\n\nTasvir ichidagi matn uchun qo‘llanma tavsiya qilganidek, avval aniq matnni yakunlang, keyin shu matnni o‘z ichiga olgan rasmni so‘rang. Yozuvlarning tili, o‘qish tartibi, joylashuvi va nisbiy urg‘usini ko‘rsating. Infografika so‘rovi har bir yozuv qaysi munosabatni tushuntirishini va uni qaysi vizual elementlar asoslashini aniqlashi kerak. Imlo, tinish belgilari va vizual bog‘lanishni haqiqiy ko‘rsatish o‘lchamida tekshiring; o‘qiladigandek ko‘ringan yaratilgan yozuv baribir nom, son yoki ko‘zlangan ma’noni o‘zgartirishi mumkin.\n\nModel kartasida ushbu nashr uchun fikrlash, qidiruv manbalari bilan asoslash, funksiya chaqirish, kod bajarish yoki sxema bilan cheklangan tuzilgan chiqish keltirilmagan. Shuningdek, u audio yaratish yoki Live API’ni e’lon qilmaydi. Uning hujjatlashtirilgan kirishi matn va tasvirlardir, shuning uchun boshqa Gemini modellaridagi audio, video va hujjat qayta ishlash xususiyatlarini ushbu profilga qo‘shish kerak emas. Ilova odatiy nasriy javob ichida tayyor tasvir materiali bor deb taxmin qilish o‘rniga, qaytgan mazmun qismlarini aniq qayta ishlashi lozim.\n\nQo‘llanma so‘ralgan tasvirlar soniga har doim ham rioya qilinmasligini va yaratilgan tasvirlarda SynthID belgisi borligini qayd etadi. Har bir qaytgan tasvirni kompozitsiya, obyektga moslik, obyektlar soni va aniq matn bo‘yicha tekshiring. Sahna bir nechta tarkibiy qismga ega bo‘lsa, ularning kerakli joylashuvini aniq tartibda tavsiflang va ko‘zlangan ko‘rinishni ijobiy shaklda ifodalang. Natija bilan birga aniq model identifikatori, prompt va namunalarni saqlang. Bu vizual yaratish yoki tahrirlash vazifasini tekshirishga yaroqli qiladi va keyingi tahrir uchun aniq boshlang‘ich nuqta beradi.", "editorialOverlay": { "copy_fields": { "practical_html": "Ingliz tilidagi texnik misol
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) matn va tasvirlardan rasmlar yaratadi hamda tahrirlaydi. Qaysi tafsilotlar saqlanishi kerakligini aytgan holda sahna tuzish, tanlangan elementni o‘zgartirish, vizual namunalarni birlashtirish yoki mahsulot tasvirini takomillashtirish uchun uning suhbatga asoslangan ish jarayonidan foydalaning.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Gemini 2.5 Flash Image, shuningdek Nano Banana nomi bilan tanilgan model — Google’ning vizual yaratish va suhbat davomida tasvir tahrirlash uchun matn va tasvir modeli. U ixtiyoriy tasvir namunalari bilan birga ko‘rsatmani qabul qiladi va hamroh matn bilan tasvirlar qaytarishi mumkin. Aynan shu 2.5 Flash Image nashri Nano Banana 2, Nano Banana Pro va keyingi Lite tasvir modellaridan farq qiladi. Uning foydali natijasi umumiy Gemini 2.5 matn modelining javobi emas, yaratilgan yoki tahrirlangan vizual materialdir.
Aynan shu model kartasida 65,536 kirish tokeni va 32,768 chiqish tokeni ko‘rsatilgan. Tasvirlar va ko‘rsatmalar kirishning, qaytgan tasvir yoki matn esa natijaning bir qismidir. Qo‘llanmaning aniqlik jadvalida qo‘llab-quvvatlanadigan tomonlar nisbatlari orasida 1:1 chiqish uchun 1024×1024, 3:4 uchun 864×1184 va 16:9 uchun 1344×768 keltirilgan. Sahnani loyihalashdan oldin mo‘ljallangan ko‘rsatish shaklini tanlang. Keyingi Gemini tasvir nashrining yuqori aniqlik variantlarini aynan shu model uchun hujjatlashtirilgan boshqaruvlar deb hisoblash kerak emas.
Matndan tasvir yaratish uchun asosiy obyekt, harakat, muhit, uslub, yoritish va ko‘rish nuqtasini ko‘rsating. Mahsulot illyustratsiyasi taqdim etilgan vizual uslubdan foydalanib, mos muhitda yaqqol ko‘rinadigan material tafsilotini so‘rashi mumkin. Model asosiy obyekt va har qanday matn uchun joy ajrata olishi uchun rasmning maqsadini tushuntiring. Yaqin ko‘rinish, yuqoridan kompozitsiya yoki past rakurs kabi fotografik tavsiflar bir-biriga aloqasiz uslub so‘zlari ro‘yxatidan ko‘ra kadrni aniqroq belgilashga yordam beradi.
Tahrir uchun asl tasvirni bering va o‘zgartiriladigan qismni belgilang. Yaratuvchi qo‘llanmasida elementlarni qo‘shish yoki olib tashlash, semantik niqoblash, uslubni ko‘chirish va namunalar yordamida kompozitsiya tuzish tasvirlangan. Foydali so‘rov tahrirni ham, saqlanadigan shartlarni ham aytadi — masalan, mahsulot shakli, sirti va yorlig‘ini saqlab, fonni o‘zgartirish. Namunalarni birlashtirganda har bir kirishning vazifasini, masalan, obyekt tashqi ko‘rinishi, muhit yoki uslubni belgilang. Qo‘llanma bu nashr uchtagacha kiruvchi tasvir bilan eng yaxshi ishlashini aytadi; bu amaliy tavsiya bo‘lib, bir-biriga zid namunalarning cheksiz to‘plamini birlashtirish uchun asos emas.
Suhbat davomida takomillashtirish muayyan vizual qarorni o‘zgartirgan holda bir xil obyektni saqlashi mumkin. Har safar bitta bog‘liq tahrirni so‘rang va shu suhbat navbatida ishlatilgan manba tasviri hamda qabul qilingan natijani saqlang. Nimalar izchil qolishi va nimalar o‘zgarishi mumkinligini tasvirlang. Materiallar turkumi uchun yangi ajratilgan prompt ularni qayta tiklaydi deb taxmin qilish o‘rniga, umumiy obyekt, ranglar va vizual qoidalarni aniq belgilang. Saqlash ko‘rsatmasi muvaffaqiyatli bajarildi deb hisoblashdan oldin tahrirlangan tasvirni namuna bilan solishtiring.
Tasvir ichidagi matn uchun qo‘llanma tavsiya qilganidek, avval aniq matnni yakunlang, keyin shu matnni o‘z ichiga olgan rasmni so‘rang. Yozuvlarning tili, o‘qish tartibi, joylashuvi va nisbiy urg‘usini ko‘rsating. Infografika so‘rovi har bir yozuv qaysi munosabatni tushuntirishini va uni qaysi vizual elementlar asoslashini aniqlashi kerak. Imlo, tinish belgilari va vizual bog‘lanishni haqiqiy ko‘rsatish o‘lchamida tekshiring; o‘qiladigandek ko‘ringan yaratilgan yozuv baribir nom, son yoki ko‘zlangan ma’noni o‘zgartirishi mumkin.
Model kartasida ushbu nashr uchun fikrlash, qidiruv manbalari bilan asoslash, funksiya chaqirish, kod bajarish yoki sxema bilan cheklangan tuzilgan chiqish keltirilmagan. Shuningdek, u audio yaratish yoki Live API’ni e’lon qilmaydi. Uning hujjatlashtirilgan kirishi matn va tasvirlardir, shuning uchun boshqa Gemini modellaridagi audio, video va hujjat qayta ishlash xususiyatlarini ushbu profilga qo‘shish kerak emas. Ilova odatiy nasriy javob ichida tayyor tasvir materiali bor deb taxmin qilish o‘rniga, qaytgan mazmun qismlarini aniq qayta ishlashi lozim.
Qo‘llanma so‘ralgan tasvirlar soniga har doim ham rioya qilinmasligini va yaratilgan tasvirlarda SynthID belgisi borligini qayd etadi. Har bir qaytgan tasvirni kompozitsiya, obyektga moslik, obyektlar soni va aniq matn bo‘yicha tekshiring. Sahna bir nechta tarkibiy qismga ega bo‘lsa, ularning kerakli joylashuvini aniq tartibda tavsiflang va ko‘zlangan ko‘rinishni ijobiy shaklda ifodalang. Natija bilan birga aniq model identifikatori, prompt va namunalarni saqlang. Bu vizual yaratish yoki tahrirlash vazifasini tekshirishga yaroqli qiladi va keyingi tahrir uchun aniq boshlang‘ich nuqta beradi.
POST /v1/chat/completionstexttext| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar google/gemini-2.5-flash-image | Standart— |
Maydonmessages | Turmessage[] | TalabMajburiy | Qiymatlar va cheklovlar Elementlarning eng kam soni: 1 | Standart— |
Maydonmessages[].role | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Namunalar: system, user, assistant, tool, function Shartlar: Bu rollar manba kodining moslik turlarida ochiq ifodalangan; aniq rollar to‘plami har bir modelga xos bo‘lib qoladi. Modelga bogʻliq | Standart— |
Maydonmessages[].content | Turstring|content_part[]|null | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydonmessages[].tool_calls | Turtool_call[] | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydonmessages[].tool_call_id | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Quyidagi holatda qo‘llanadi: role=tool; haqiqatan qaytarilgan IDdan foydalaning | Standart— |
Maydonmessages[].name | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydonmessages[].reasoning_content | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Quyidagi holatda qo‘llanadi: Ushbu model foydalanganda, haqiqatan qaytarilgan fikrlash ma’lumotlarini keyingi so‘rovda qayta yuboring | Standart— |
Maydonmessages[].reasoning_details | Turobject|array | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonmax_tokens | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 Modelga bogʻliq | Standart— |
Maydonmax_completion_tokens | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 Modelga bogʻliq | Standart— |
Maydonstream | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standartfalse |
Maydonstream_options.include_usage | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydontemperature | Turnumber | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydontop_p | Turnumber | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonstop | Turstring|string[] | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydontools | Turfunction_tool[] | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydontools[].type | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar function Modelga bogʻliq | Standart— |
Maydontools[].function.name | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Quyidagi holatda qo‘llanadi: Funksiya vositasi taqdim etilgan | Standart— |
Maydontools[].function.description | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydontools[].function.parameters | TurJSON_schema | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydontool_choice | Turstring|object | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonparallel_tool_calls | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonresponse_format | Turobject | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonreasoning_effort | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonreasoning | Turobject | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonservice_tier | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydoninstructions | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Moslik maydoni | Standart— |
Maydonfunctions | Turfunction[] | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonfunction_call | Turstring|object | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonprompt_cache_options | Turobject | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonmodalities | Turstring[] | TalabIxtiyoriy | Qiymatlar va cheklovlar text | Standart— |
Maydonprovider | Turobject | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Ushbu Ultra matn marshrutida provider.options rad etiladi | Standart— |
Maydoncache_control.ttl | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Shartlar: Haqiqiy prompt-kesh joylarida 1h rad etiladi | Standart— |
Matn · UTF8 matni
messages[].content
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, messages |
Parametrmaterial_types | Parametr talablaritext |
Parametrmessages | Parametr talablarirole/content tuzilishidagi xabarlar massivi |
Parametrfile_material | Parametr talablariHaqiqiy UTF-8 hujjati aynan matn sifatida kiritiladi; fayl IDsi faraz qilinmaydi |
Parametroptional_controls | Parametr talablaristream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametrcontrol_scope | Parametr talablariModelga xos; foydalanuvchi funksiya vositalari hostingdagi vositalardan farq qiladi |
Parametroutput_modalities | Parametr talablaritext |
Parametrhosted_operations | Parametr talablarifalse |
Parametrmultimodal_input_binding | Parametr talablarinull |
Hayot sikli: synchronous_or_streamed
Aniq model IDsini messages bilan yuboring.
Kontekst uzunligi chiqishning yuqori chegarasi emas.
Matn fayli aynan matnni taqdim etishi mumkin; tasvir, audio va fayl obyekti kirishlari aniq bog‘lashni talab qiladi.
Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | Tariflar jadvali | Kontekst tokenlari soni bundan ko‘p | Kontekst tokenlari soni bundan oshmaydi, chegara kiradi | To‘lov |
|---|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Kontekst tokenlari soni bundan ko‘p— | Kontekst tokenlari soni bundan oshmaydi, chegara kiradiYuqori chegara yo‘q | To‘lov Kirish · Kirish tokenlari $0.0006 / 1K token Chiqish · Chiqish tokenlari $0.005 / 1K token Kirish · Keshdan o‘qish $0.00006 / 1K token Kirish · Keshga yozish $0.0001666666666666666 / 1K token Kirish · Keshga yozish, 1 soat — / 1K token Chiqish · Chiqish rasmi tokenlari $0.06 / 1K rasm tokeni |
| SozlamaSo‘rov uzunligi bo‘yicha 1-daraja | Tariflar jadvali— | Kontekst tokenlari soni bundan ko‘p0 | Kontekst tokenlari soni bundan oshmaydi, chegara kiradiYuqori chegara yo‘q | To‘lov Kirish · Kirish tokenlari $0.0006 / 1K token Chiqish · Chiqish tokenlari $0.005 / 1K token Kirish · Keshdan o‘qish $0.00006 / 1K token Kirish · Keshga yozish $0.0001666666666666666 / 1K token Kirish · Keshga yozish, 1 soat — / 1K token |
Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.
| Sozlama | To‘lovni hisoblash shartlari | To‘lov |
|---|---|---|
| Sozlamagoogle/gemini-2.5-flash-image · Standart sozlama | To‘lovni hisoblash shartlariStandart konfiguratsiya | To‘lov Kirish · Kirish 0,0006 US$ / 1K token Chiqish · Chiqish 0,06 US$ / 1K token |
| Sozlama | To‘lovni hisoblash shartlari | To‘lov |
|---|---|---|
| SozlamaGoogle: Nano Banana (Gemini 2.5 Flash Image) · Standart sozlama | To‘lovni hisoblash shartlariStandart konfiguratsiya | To‘lov Kirish · Kirish tokenlari 0,0006 US$ / 1K token Chiqish · Chiqish tokenlari 0,005 US$ / 1K token Kirish · Kirish rasmi 0,0006 US$ / 1K token Chiqish · Chiqish rasmi 0,06 US$ / 1K token Kirish · Kirish audiosi 0,002 US$ / 1K token Kirish · Audio keshini o‘qish 0,0002 US$ / 1K token Chiqish · Veb-qidiruv 0,028 US$ har bir qidiruv uchun Chiqish · Mantiqiy fikrlash tokenlari 0,005 US$ / 1K token Kirish · Keshdan o‘qish 0,00006 US$ / 1K token Kirish · Keshga yozish · 5 daqiqa ≈0,000167 US$ / 1K token |
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
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 yoki SSE
Qaytarilgan har bir to‘liq javob, fayl va kontent qismini saqlang.
Har bir javob variantini va uning kontenti, vosita chaqiruvlari hamda fikrlash ma’lumotlarini saqlang. SSEda o‘zgarish qismlarini variant va vosita indeksi bo‘yicha yig‘ing, yakuniy tugash sababi va sarf ma’lumotlarini saqlang.
So‘rov va javob IDlari hamda sarlavhalarini saqlang. Matn vazifasini olish uchun umumiy URL taqdim etilmagan.
| Maydon | Tur |
|---|---|
Maydonchoices[].index | Turinteger |
Maydonchoices[].message.content | Turstring|null |
Maydonchoices[].message.tool_calls | Turtool_call[] |
Maydonchoices[].message.reasoning_content | Turstring |
Maydonchoices[].message.reasoning_details | Turobject|array |
Maydonchoices[].finish_reason | Turstring|null |
Maydonusage | Turobject |
| Javob | Shart | Keyingi qadam |
|---|---|---|
Javob400 · invalid_request_error | ShartMajburiy maydonlar, material ifodasi yoki parametr qiymati noto‘g‘ri | Keyingi qadamYangi yaratish so‘rovidan oldin ko‘rsatilgan maydonlarni tuzating. |
Ailoot Ultra google/gemini-2.5-flash-image
/v1/images
google/gemini-2.5-flash-imageNano Banana (Gemini 2.5 Flash Image) matn va tasvirlardan rasmlar yaratadi hamda tahrirlaydi. Qaysi tafsilotlar saqlanishi kerakligini aytgan holda sahna tuzish, tanlangan elementni o‘zgartirish, vizual namunalarni birlashtirish yoki mahsulot tasvirini takomillashtirish uchun uning suhbatga asoslangan ish jarayonidan foydalaning.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Gemini 2.5 Flash Image, shuningdek Nano Banana nomi bilan tanilgan model — Google’ning vizual yaratish va suhbat davomida tasvir tahrirlash uchun matn va tasvir modeli. U ixtiyoriy tasvir namunalari bilan birga ko‘rsatmani qabul qiladi va hamroh matn bilan tasvirlar qaytarishi mumkin. Aynan shu 2.5 Flash Image nashri Nano Banana 2, Nano Banana Pro va keyingi Lite tasvir modellaridan farq qiladi. Uning foydali natijasi umumiy Gemini 2.5 matn modelining javobi emas, yaratilgan yoki tahrirlangan vizual materialdir.
Aynan shu model kartasida 65,536 kirish tokeni va 32,768 chiqish tokeni ko‘rsatilgan. Tasvirlar va ko‘rsatmalar kirishning, qaytgan tasvir yoki matn esa natijaning bir qismidir. Qo‘llanmaning aniqlik jadvalida qo‘llab-quvvatlanadigan tomonlar nisbatlari orasida 1:1 chiqish uchun 1024×1024, 3:4 uchun 864×1184 va 16:9 uchun 1344×768 keltirilgan. Sahnani loyihalashdan oldin mo‘ljallangan ko‘rsatish shaklini tanlang. Keyingi Gemini tasvir nashrining yuqori aniqlik variantlarini aynan shu model uchun hujjatlashtirilgan boshqaruvlar deb hisoblash kerak emas.
Matndan tasvir yaratish uchun asosiy obyekt, harakat, muhit, uslub, yoritish va ko‘rish nuqtasini ko‘rsating. Mahsulot illyustratsiyasi taqdim etilgan vizual uslubdan foydalanib, mos muhitda yaqqol ko‘rinadigan material tafsilotini so‘rashi mumkin. Model asosiy obyekt va har qanday matn uchun joy ajrata olishi uchun rasmning maqsadini tushuntiring. Yaqin ko‘rinish, yuqoridan kompozitsiya yoki past rakurs kabi fotografik tavsiflar bir-biriga aloqasiz uslub so‘zlari ro‘yxatidan ko‘ra kadrni aniqroq belgilashga yordam beradi.
Tahrir uchun asl tasvirni bering va o‘zgartiriladigan qismni belgilang. Yaratuvchi qo‘llanmasida elementlarni qo‘shish yoki olib tashlash, semantik niqoblash, uslubni ko‘chirish va namunalar yordamida kompozitsiya tuzish tasvirlangan. Foydali so‘rov tahrirni ham, saqlanadigan shartlarni ham aytadi — masalan, mahsulot shakli, sirti va yorlig‘ini saqlab, fonni o‘zgartirish. Namunalarni birlashtirganda har bir kirishning vazifasini, masalan, obyekt tashqi ko‘rinishi, muhit yoki uslubni belgilang. Qo‘llanma bu nashr uchtagacha kiruvchi tasvir bilan eng yaxshi ishlashini aytadi; bu amaliy tavsiya bo‘lib, bir-biriga zid namunalarning cheksiz to‘plamini birlashtirish uchun asos emas.
Suhbat davomida takomillashtirish muayyan vizual qarorni o‘zgartirgan holda bir xil obyektni saqlashi mumkin. Har safar bitta bog‘liq tahrirni so‘rang va shu suhbat navbatida ishlatilgan manba tasviri hamda qabul qilingan natijani saqlang. Nimalar izchil qolishi va nimalar o‘zgarishi mumkinligini tasvirlang. Materiallar turkumi uchun yangi ajratilgan prompt ularni qayta tiklaydi deb taxmin qilish o‘rniga, umumiy obyekt, ranglar va vizual qoidalarni aniq belgilang. Saqlash ko‘rsatmasi muvaffaqiyatli bajarildi deb hisoblashdan oldin tahrirlangan tasvirni namuna bilan solishtiring.
Tasvir ichidagi matn uchun qo‘llanma tavsiya qilganidek, avval aniq matnni yakunlang, keyin shu matnni o‘z ichiga olgan rasmni so‘rang. Yozuvlarning tili, o‘qish tartibi, joylashuvi va nisbiy urg‘usini ko‘rsating. Infografika so‘rovi har bir yozuv qaysi munosabatni tushuntirishini va uni qaysi vizual elementlar asoslashini aniqlashi kerak. Imlo, tinish belgilari va vizual bog‘lanishni haqiqiy ko‘rsatish o‘lchamida tekshiring; o‘qiladigandek ko‘ringan yaratilgan yozuv baribir nom, son yoki ko‘zlangan ma’noni o‘zgartirishi mumkin.
Model kartasida ushbu nashr uchun fikrlash, qidiruv manbalari bilan asoslash, funksiya chaqirish, kod bajarish yoki sxema bilan cheklangan tuzilgan chiqish keltirilmagan. Shuningdek, u audio yaratish yoki Live API’ni e’lon qilmaydi. Uning hujjatlashtirilgan kirishi matn va tasvirlardir, shuning uchun boshqa Gemini modellaridagi audio, video va hujjat qayta ishlash xususiyatlarini ushbu profilga qo‘shish kerak emas. Ilova odatiy nasriy javob ichida tayyor tasvir materiali bor deb taxmin qilish o‘rniga, qaytgan mazmun qismlarini aniq qayta ishlashi lozim.
Qo‘llanma so‘ralgan tasvirlar soniga har doim ham rioya qilinmasligini va yaratilgan tasvirlarda SynthID belgisi borligini qayd etadi. Har bir qaytgan tasvirni kompozitsiya, obyektga moslik, obyektlar soni va aniq matn bo‘yicha tekshiring. Sahna bir nechta tarkibiy qismga ega bo‘lsa, ularning kerakli joylashuvini aniq tartibda tavsiflang va ko‘zlangan ko‘rinishni ijobiy shaklda ifodalang. Natija bilan birga aniq model identifikatori, prompt va namunalarni saqlang. Bu vizual yaratish yoki tahrirlash vazifasini tekshirishga yaroqli qiladi va keyingi tahrir uchun aniq boshlang‘ich nuqta beradi.
POST /v1/images/generationstext, imageimage| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar google/gemini-2.5-flash-image | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Eng kam uzunlik: 1 | Standart— |
Maydonaspect_ratio | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | Standart— |
Maydonn | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 1 | Standart— |
Maydoninput_references | Turarray | TalabIxtiyoriy | Qiymatlar va cheklovlar Elementlarning eng kam soni: 0 Elementlarning eng ko‘p soni: 3 | Standart— |
Maydonprovider | Turobject | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, prompt |
Parametrmaterial_types | Parametr talablaritext, image |
Hayot sikli: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Amalda qaytarilgan task_id yoki media kutubxonasidagi yozuv
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.
Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | Tariflar jadvali | Prognoz miqdori | To‘lov |
|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Prognoz miqdori— | To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token |
| SozlamaYaratishning taxminiy qiymati | Tariflar jadvali— | Prognoz miqdoribir generatsiya uchun taxmin | To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.24576 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas. |
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
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\nHar bir qaytarilgan rasmni yuklab oling yoki uning Base64 kontentini saqlang
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.\nHar bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.
To‘liq javob va sarlavhalarni, amalda qaytarilgan barcha natijalarni, dastlab qaytarilgan identifikatorlarni hamda barcha usage maydonlarini saqlang. Yaratish so‘rovini qayta yubormasdan dastlabki operatsiyani tiklang.
Qaytarilgan X-Client-Request-ID ni ma’lumotlarni solishtirib tekshirish uchun saqlang. Faqat amalda qaytarilgan task_id/asset_id qiymatlari bo‘yicha yoki o‘zingizga tegishli media kutubxonasidan ma’lumot o‘qing; operatsiya ID sidan vazifa URL manzilini hech qachon tuzmang va yaratish so‘rovini qayta yubormang.
| Maydon | Tur |
|---|---|
Maydoncreated | Tur |
Maydondata[].url | Tur |
Maydondata[].b64_json | Tur |
Maydonusage | Tur |
Ailoot Ultra google/gemini-2.5-flash-image
/v1/images
google/gemini-2.5-flash-imageNano Banana (Gemini 2.5 Flash Image) matn va tasvirlardan rasmlar yaratadi hamda tahrirlaydi. Qaysi tafsilotlar saqlanishi kerakligini aytgan holda sahna tuzish, tanlangan elementni o‘zgartirish, vizual namunalarni birlashtirish yoki mahsulot tasvirini takomillashtirish uchun uning suhbatga asoslangan ish jarayonidan foydalaning.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Gemini 2.5 Flash Image, shuningdek Nano Banana nomi bilan tanilgan model — Google’ning vizual yaratish va suhbat davomida tasvir tahrirlash uchun matn va tasvir modeli. U ixtiyoriy tasvir namunalari bilan birga ko‘rsatmani qabul qiladi va hamroh matn bilan tasvirlar qaytarishi mumkin. Aynan shu 2.5 Flash Image nashri Nano Banana 2, Nano Banana Pro va keyingi Lite tasvir modellaridan farq qiladi. Uning foydali natijasi umumiy Gemini 2.5 matn modelining javobi emas, yaratilgan yoki tahrirlangan vizual materialdir.
Aynan shu model kartasida 65,536 kirish tokeni va 32,768 chiqish tokeni ko‘rsatilgan. Tasvirlar va ko‘rsatmalar kirishning, qaytgan tasvir yoki matn esa natijaning bir qismidir. Qo‘llanmaning aniqlik jadvalida qo‘llab-quvvatlanadigan tomonlar nisbatlari orasida 1:1 chiqish uchun 1024×1024, 3:4 uchun 864×1184 va 16:9 uchun 1344×768 keltirilgan. Sahnani loyihalashdan oldin mo‘ljallangan ko‘rsatish shaklini tanlang. Keyingi Gemini tasvir nashrining yuqori aniqlik variantlarini aynan shu model uchun hujjatlashtirilgan boshqaruvlar deb hisoblash kerak emas.
Matndan tasvir yaratish uchun asosiy obyekt, harakat, muhit, uslub, yoritish va ko‘rish nuqtasini ko‘rsating. Mahsulot illyustratsiyasi taqdim etilgan vizual uslubdan foydalanib, mos muhitda yaqqol ko‘rinadigan material tafsilotini so‘rashi mumkin. Model asosiy obyekt va har qanday matn uchun joy ajrata olishi uchun rasmning maqsadini tushuntiring. Yaqin ko‘rinish, yuqoridan kompozitsiya yoki past rakurs kabi fotografik tavsiflar bir-biriga aloqasiz uslub so‘zlari ro‘yxatidan ko‘ra kadrni aniqroq belgilashga yordam beradi.
Tahrir uchun asl tasvirni bering va o‘zgartiriladigan qismni belgilang. Yaratuvchi qo‘llanmasida elementlarni qo‘shish yoki olib tashlash, semantik niqoblash, uslubni ko‘chirish va namunalar yordamida kompozitsiya tuzish tasvirlangan. Foydali so‘rov tahrirni ham, saqlanadigan shartlarni ham aytadi — masalan, mahsulot shakli, sirti va yorlig‘ini saqlab, fonni o‘zgartirish. Namunalarni birlashtirganda har bir kirishning vazifasini, masalan, obyekt tashqi ko‘rinishi, muhit yoki uslubni belgilang. Qo‘llanma bu nashr uchtagacha kiruvchi tasvir bilan eng yaxshi ishlashini aytadi; bu amaliy tavsiya bo‘lib, bir-biriga zid namunalarning cheksiz to‘plamini birlashtirish uchun asos emas.
Suhbat davomida takomillashtirish muayyan vizual qarorni o‘zgartirgan holda bir xil obyektni saqlashi mumkin. Har safar bitta bog‘liq tahrirni so‘rang va shu suhbat navbatida ishlatilgan manba tasviri hamda qabul qilingan natijani saqlang. Nimalar izchil qolishi va nimalar o‘zgarishi mumkinligini tasvirlang. Materiallar turkumi uchun yangi ajratilgan prompt ularni qayta tiklaydi deb taxmin qilish o‘rniga, umumiy obyekt, ranglar va vizual qoidalarni aniq belgilang. Saqlash ko‘rsatmasi muvaffaqiyatli bajarildi deb hisoblashdan oldin tahrirlangan tasvirni namuna bilan solishtiring.
Tasvir ichidagi matn uchun qo‘llanma tavsiya qilganidek, avval aniq matnni yakunlang, keyin shu matnni o‘z ichiga olgan rasmni so‘rang. Yozuvlarning tili, o‘qish tartibi, joylashuvi va nisbiy urg‘usini ko‘rsating. Infografika so‘rovi har bir yozuv qaysi munosabatni tushuntirishini va uni qaysi vizual elementlar asoslashini aniqlashi kerak. Imlo, tinish belgilari va vizual bog‘lanishni haqiqiy ko‘rsatish o‘lchamida tekshiring; o‘qiladigandek ko‘ringan yaratilgan yozuv baribir nom, son yoki ko‘zlangan ma’noni o‘zgartirishi mumkin.
Model kartasida ushbu nashr uchun fikrlash, qidiruv manbalari bilan asoslash, funksiya chaqirish, kod bajarish yoki sxema bilan cheklangan tuzilgan chiqish keltirilmagan. Shuningdek, u audio yaratish yoki Live API’ni e’lon qilmaydi. Uning hujjatlashtirilgan kirishi matn va tasvirlardir, shuning uchun boshqa Gemini modellaridagi audio, video va hujjat qayta ishlash xususiyatlarini ushbu profilga qo‘shish kerak emas. Ilova odatiy nasriy javob ichida tayyor tasvir materiali bor deb taxmin qilish o‘rniga, qaytgan mazmun qismlarini aniq qayta ishlashi lozim.
Qo‘llanma so‘ralgan tasvirlar soniga har doim ham rioya qilinmasligini va yaratilgan tasvirlarda SynthID belgisi borligini qayd etadi. Har bir qaytgan tasvirni kompozitsiya, obyektga moslik, obyektlar soni va aniq matn bo‘yicha tekshiring. Sahna bir nechta tarkibiy qismga ega bo‘lsa, ularning kerakli joylashuvini aniq tartibda tavsiflang va ko‘zlangan ko‘rinishni ijobiy shaklda ifodalang. Natija bilan birga aniq model identifikatori, prompt va namunalarni saqlang. Bu vizual yaratish yoki tahrirlash vazifasini tekshirishga yaroqli qiladi va keyingi tahrir uchun aniq boshlang‘ich nuqta beradi.
POST /v1/messagestextjson, sse| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar google/gemini-2.5-flash-image | Standart— |
Maydonmessages | Turmessage[] | TalabMajburiy | Qiymatlar va cheklovlar | Standart— |
Maydonmessages[].role | Turstring | TalabMajburiy | Qiymatlar va cheklovlar user, assistant | Standart— |
Maydonmessages[].content | Turstring | TalabMajburiy | Qiymatlar va cheklovlar | Standart— |
Maydonmax_tokens | Turinteger | TalabMajburiy | Qiymatlar va cheklovlar | Standart— |
Maydonstream | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standartfalse |
Matn · UTF-8 matni
messages[].content satri
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, messages, max_tokens |
Parametroptional_controls | Parametr talablaristream |
Parametrmaterial_types | Parametr talablaritext |
Parametrtext_file_material | Parametr talablariHaqiqiy UTF-8 hujjatini o‘qing va uning matnini ko‘rsatilgan kirish yoki xabar kontenti satriga joylashtiring. |
Hayot sikli: synchronous_or_streamed
Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | Tariflar jadvali | Kontekst tokenlari soni bundan ko‘p | Kontekst tokenlari soni bundan oshmaydi, chegara kiradi | To‘lov |
|---|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Kontekst tokenlari soni bundan ko‘p— | Kontekst tokenlari soni bundan oshmaydi, chegara kiradiYuqori chegara yo‘q | To‘lov Kirish · Kirish tokenlari $0.0006 / 1K token Chiqish · Chiqish tokenlari $0.005 / 1K token Kirish · Keshdan o‘qish $0.00006 / 1K token Kirish · Keshga yozish $0.0001666666666666666 / 1K token Kirish · Keshga yozish, 1 soat — / 1K token Chiqish · Chiqish rasmi tokenlari $0.06 / 1K rasm tokeni |
| SozlamaSo‘rov uzunligi bo‘yicha 1-daraja | Tariflar jadvali— | Kontekst tokenlari soni bundan ko‘p0 | Kontekst tokenlari soni bundan oshmaydi, chegara kiradiYuqori chegara yo‘q | To‘lov Kirish · Kirish tokenlari $0.0006 / 1K token Chiqish · Chiqish tokenlari $0.005 / 1K token Kirish · Keshdan o‘qish $0.00006 / 1K token Kirish · Keshga yozish $0.0001666666666666666 / 1K token Kirish · Keshga yozish, 1 soat — / 1K token |
Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →
{\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 yoki SSE
Qaytarilgan har bir to‘liq javob, fayl va kontent qismini saqlang.
Barcha kontent bloklari, fikrlash imzolari va haqiqiy vosita ishlatish IDlarini saqlang. SSE bloklarining barcha o‘zgarish qismlarini yig‘ing; birinchi matn bloki to‘liq chiqish emas.
So‘rov va javob IDlari hamda sarlavhalarini saqlang. Matn vazifasini olish uchun umumiy URL taqdim etilmagan.
| Maydon | Tur |
|---|---|
Maydonid | Turstring |
Maydonmodel | Turstring |
Maydoncontent[] | Turtext|thinking|tool_use|other content block |
Maydonstop_reason | Turstring|null |
Maydonusage | Turobject |
| Javob | Shart | Keyingi qadam |
|---|---|---|
Javob400 · invalid_request_error | ShartMajburiy maydonlar, material ifodasi yoki parametr qiymati noto‘g‘ri | Keyingi qadamYangi yaratish so‘rovidan oldin ko‘rsatilgan maydonlarni tuzating. |
Ailoot Ultra google/gemini-2.5-flash-image
/v1/images
Ingliz tilidagi texnik misol
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.