Nano Banana Pro — Google’ning mulohaza yuritishga tayangan tasvir yaratish va tahrirlash uchun Gemini 3 Pro Image modeli. Ishlab chiqaruvchi uning asosiy qo‘llanishlari markaziga murakkab grafik dizayn, asliga juda mos mahsulot maketlari va faktik ma’lumotlarni vizualizatsiya qilishni qo‘yadi. U matn va tasvirlarni qabul qiladi hamda tasvir va matn yaratadi. Ushbu nomlangan Pro tasvir nashri Gemini 3 Pro asosida yaratilgan bo‘lsa-da, tasvir vazifalari uchun o‘zining kirish va imkoniyatlar profilini saqlaydi.
Model 1K, 2K va 4K tasvirlarni qo‘llab-quvvatlaydi. Hujjatlashtirilgan shakllarga 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 va 21:9 kiradi. Kvadrat 4K tasvir 4096 × 4096; 16:9 nisbatdagi 4K tasvir esa 5504 × 3072. Portret poster, mahsulot sahnasi yoki keng tushuntiruvchi grafika bo‘lishidan qat’i nazar, aniqlik va tomonlar nisbatini kerakli materialga mos tanlang. Gemini 3.1 Flash Image’ning 0.5K varianti va qo‘shimcha keskin nisbatlari ushbu Pro jadvaliga kirmaydi.
Matnni tasvirga tushirish posterlar, diagrammalar va boshqa dizayn materiallarida aniq yozuvlarni qo‘llab-quvvatlaydi. Murakkab infografika uchun asosiy faktlar, aniq matn, o‘qish ketma-ketligi va yozuvlar bilan vizual elementlar o‘rtasidagi munosabatni bering. Yetkaziladigan ma’lumotni kerakli badiiy uslubdan ajrating. Google avval matnni tayyorlashni, keyin uni o‘z ichiga olgan tasvirni yaratishni tavsiya qiladi. Bu kompozitsiyada sarlavha, diagramma va bir nechta qisqa izoh birlashganda ayniqsa foydali.
Bir nechta tasvir kirishi 14 tagacha namunani qo‘llab-quvvatlaydi. Google imkoniyatlar jadvalida moslik uchun oltitagacha obyekt namunasi, izchillik uchun beshtagacha qahramon namunasi va uchtagacha uslub namunasi tavsiflangan. Bu vazifalar tarkibiy vizualni tayyorlashga yordam beradi: mahsulot fotosurati tashqi ko‘rinishni belgilaydi, alohida rasm muhitni beradi, uslub tasviri esa ishlov yo‘nalishini ko‘rsatadi. Har bir ko‘rinadigan xususiyatni farqlamasdan birlashtirishni so‘rash o‘rniga, qaysi tafsilotlar asosiy ishonchli manba va qaysi namunalar ilhom manbai ekanini modelga ayting.
Google Search orqali manbalarga asoslash faktik vizualizatsiya yoki dolzarb sharoitlarga tayangan sahna uchun haqiqiy dunyo ma’lumotlarini berishi mumkin. Pro tasvir ish jarayonida veb manbalariga asoslash hujjatlashtirilgan; Image Search kengaytmasi esa aynan Nano Banana 2.1 va Gemini 3.1 Flash Image uchun hujjatlashtirilgan. Ma’lumot grafikasida ko‘rsatmoqchi bo‘lgan qiymatlarni bering yoki ishlab chiqaruvchi ish jarayonida manbalarga asoslangan ma’lumotni so‘rang, so‘ng munosabat, yozuvlar va joylashuvni aniq qiling. Qidiruvga tayangan generatsiya baribir tekshiriladigan tasvir yaratadi va tasvirlangan faktlarni tekshirish o‘rnini bosmaydi.
Mulohaza yuritish yakuniy tasvirlashdan oldin murakkab prompt kompozitsiyasini tuzishga yordam beradi. Tasvir qo‘llanmasida kompozitsiya va mantiqni sinash uchun ishlatiladigan, yakuniy materialdan farqli oraliq tasvirlar tavsiflangan. Nano Banana 2’ning minimal/high boshqaruv jadvalini yoki Nano Banana 2.1’ning standart darajasi medium bo‘lgan jadvalini ushbu Pro nashriga ko‘chirmang. Talabchan dizayn uchun vizual iyerarxiya, obyektlar o‘rtasidagi zarur munosabatlar va keyingi tahrirlarda saqlanishi shart bo‘lgan elementlardan iborat to‘liq topshiriq bering.
Model kartasida hali mavjud bo‘lgan muhim cheklovlar tasvirlangan: juda mayda matn va uzun parchalar yomon chiqishi, qahramon tashqi ko‘rinishi namunadan natijagacha o‘zgarishi, niqobli yoki qoralama chizmalarga asoslangan tahrirlar esa ko‘rsatmaga faqat qisman rioya qilishi yoki iz qoldirishi mumkin. U chap va o‘ngni ham chalkashtirishi yoki manba elementini yangi kompozitsiyaga ko‘chirishi mumkin. Mahsulotni tahrirlashda saqlanadigan geometriya va yozuvlarni aniq ayting hamda tahrirlangan hududni tekshiring; diagrammada esa strelkalar yo‘nalishi va obyektlarning bir-biriga nisbatan joylashuvini solishtiring.
Amaldagi API jadvalida kirish chegarasi 65,536 token, chiqish chegarasi 32,768 token deb ko‘rsatilgan. Tasvir yaratish, fikrlash, qidiruv manbalari bilan asoslash va paketli ishlov qo‘llab-quvvatlanadi; audio yaratish, funksiya chaqirish, kod bajarish, keshlash, tuzilgan chiqishlar, fayl qidirish, URL konteksti va Live API qo‘llab-quvvatlanmaydi. Ushbu profildagi tasvir vazifasi audio ham, video kirishini ham qabul qilmaydi. Yaratilgan tasvirlarda SynthID bor, so‘ralgan chiqish tasvirlari soniga esa har doim aynan rioya qilinmaydi.
Amaliy mahsulot topshirig‘i mahsulot tasviri, yoritish namunasi va aniq sarlavhani birlashtirishi mumkin: “Mahsulot nisbatlari va yozuvlarini saqlang, uni yumshoq yon yorug‘lik ostidagi och rangli tosh sirtida ko‘rsating va yuqori uchdan bir qismini berilgan sarlavha uchun bo‘sh qoldiring.” Faktik diagramma uchun har bir obyekt va bog‘lanishni belgilang hamda tasdiqlangan yozuvlarni bering. Suhbatda bitta o‘zgarish va saqlanadigan xususiyatlarni aytib natijani takomillashtiring, tanlangan tasvir va uning izohlovchi matnini dizayn materiali sifatida birga saqlang.
", "aboutText": "Nano Banana Pro — Google’ning mulohaza yuritishga tayangan tasvir yaratish va tahrirlash uchun Gemini 3 Pro Image modeli. Ishlab chiqaruvchi uning asosiy qo‘llanishlari markaziga murakkab grafik dizayn, asliga juda mos mahsulot maketlari va faktik ma’lumotlarni vizualizatsiya qilishni qo‘yadi. U matn va tasvirlarni qabul qiladi hamda tasvir va matn yaratadi. Ushbu nomlangan Pro tasvir nashri Gemini 3 Pro asosida yaratilgan bo‘lsa-da, tasvir vazifalari uchun o‘zining kirish va imkoniyatlar profilini saqlaydi.\n\nModel 1K, 2K va 4K tasvirlarni qo‘llab-quvvatlaydi. Hujjatlashtirilgan shakllarga 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 va 21:9 kiradi. Kvadrat 4K tasvir 4096 × 4096; 16:9 nisbatdagi 4K tasvir esa 5504 × 3072. Portret poster, mahsulot sahnasi yoki keng tushuntiruvchi grafika bo‘lishidan qat’i nazar, aniqlik va tomonlar nisbatini kerakli materialga mos tanlang. Gemini 3.1 Flash Image’ning 0.5K varianti va qo‘shimcha keskin nisbatlari ushbu Pro jadvaliga kirmaydi.\n\nMatnni tasvirga tushirish posterlar, diagrammalar va boshqa dizayn materiallarida aniq yozuvlarni qo‘llab-quvvatlaydi. Murakkab infografika uchun asosiy faktlar, aniq matn, o‘qish ketma-ketligi va yozuvlar bilan vizual elementlar o‘rtasidagi munosabatni bering. Yetkaziladigan ma’lumotni kerakli badiiy uslubdan ajrating. Google avval matnni tayyorlashni, keyin uni o‘z ichiga olgan tasvirni yaratishni tavsiya qiladi. Bu kompozitsiyada sarlavha, diagramma va bir nechta qisqa izoh birlashganda ayniqsa foydali.\n\nBir nechta tasvir kirishi 14 tagacha namunani qo‘llab-quvvatlaydi. Google imkoniyatlar jadvalida moslik uchun oltitagacha obyekt namunasi, izchillik uchun beshtagacha qahramon namunasi va uchtagacha uslub namunasi tavsiflangan. Bu vazifalar tarkibiy vizualni tayyorlashga yordam beradi: mahsulot fotosurati tashqi ko‘rinishni belgilaydi, alohida rasm muhitni beradi, uslub tasviri esa ishlov yo‘nalishini ko‘rsatadi. Har bir ko‘rinadigan xususiyatni farqlamasdan birlashtirishni so‘rash o‘rniga, qaysi tafsilotlar asosiy ishonchli manba va qaysi namunalar ilhom manbai ekanini modelga ayting.\n\nGoogle Search orqali manbalarga asoslash faktik vizualizatsiya yoki dolzarb sharoitlarga tayangan sahna uchun haqiqiy dunyo ma’lumotlarini berishi mumkin. Pro tasvir ish jarayonida veb manbalariga asoslash hujjatlashtirilgan; Image Search kengaytmasi esa aynan Nano Banana 2.1 va Gemini 3.1 Flash Image uchun hujjatlashtirilgan. Ma’lumot grafikasida ko‘rsatmoqchi bo‘lgan qiymatlarni bering yoki ishlab chiqaruvchi ish jarayonida manbalarga asoslangan ma’lumotni so‘rang, so‘ng munosabat, yozuvlar va joylashuvni aniq qiling. Qidiruvga tayangan generatsiya baribir tekshiriladigan tasvir yaratadi va tasvirlangan faktlarni tekshirish o‘rnini bosmaydi.\n\nMulohaza yuritish yakuniy tasvirlashdan oldin murakkab prompt kompozitsiyasini tuzishga yordam beradi. Tasvir qo‘llanmasida kompozitsiya va mantiqni sinash uchun ishlatiladigan, yakuniy materialdan farqli oraliq tasvirlar tavsiflangan. Nano Banana 2’ning minimal/high boshqaruv jadvalini yoki Nano Banana 2.1’ning standart darajasi medium bo‘lgan jadvalini ushbu Pro nashriga ko‘chirmang. Talabchan dizayn uchun vizual iyerarxiya, obyektlar o‘rtasidagi zarur munosabatlar va keyingi tahrirlarda saqlanishi shart bo‘lgan elementlardan iborat to‘liq topshiriq bering.\n\nModel kartasida hali mavjud bo‘lgan muhim cheklovlar tasvirlangan: juda mayda matn va uzun parchalar yomon chiqishi, qahramon tashqi ko‘rinishi namunadan natijagacha o‘zgarishi, niqobli yoki qoralama chizmalarga asoslangan tahrirlar esa ko‘rsatmaga faqat qisman rioya qilishi yoki iz qoldirishi mumkin. U chap va o‘ngni ham chalkashtirishi yoki manba elementini yangi kompozitsiyaga ko‘chirishi mumkin. Mahsulotni tahrirlashda saqlanadigan geometriya va yozuvlarni aniq ayting hamda tahrirlangan hududni tekshiring; diagrammada esa strelkalar yo‘nalishi va obyektlarning bir-biriga nisbatan joylashuvini solishtiring.\n\nAmaldagi API jadvalida kirish chegarasi 65,536 token, chiqish chegarasi 32,768 token deb ko‘rsatilgan. Tasvir yaratish, fikrlash, qidiruv manbalari bilan asoslash va paketli ishlov qo‘llab-quvvatlanadi; audio yaratish, funksiya chaqirish, kod bajarish, keshlash, tuzilgan chiqishlar, fayl qidirish, URL konteksti va Live API qo‘llab-quvvatlanmaydi. Ushbu profildagi tasvir vazifasi audio ham, video kirishini ham qabul qilmaydi. Yaratilgan tasvirlarda SynthID bor, so‘ralgan chiqish tasvirlari soniga esa har doim aynan rioya qilinmaydi.\n\nAmaliy mahsulot topshirig‘i mahsulot tasviri, yoritish namunasi va aniq sarlavhani birlashtirishi mumkin: “Mahsulot nisbatlari va yozuvlarini saqlang, uni yumshoq yon yorug‘lik ostidagi och rangli tosh sirtida ko‘rsating va yuqori uchdan bir qismini berilgan sarlavha uchun bo‘sh qoldiring.” Faktik diagramma uchun har bir obyekt va bog‘lanishni belgilang hamda tasdiqlangan yozuvlarni bering. Suhbatda bitta o‘zgarish va saqlanadigan xususiyatlarni aytib natijani takomillashtiring, tanlangan tasvir va uning izohlovchi matnini dizayn materiali sifatida birga saqlang.", "editorialOverlay": { "copy_fields": { "practical_html": "Ingliz tilidagi texnik misol
Visualize a supplied packaging cycle\n\nCreate one landscape explanatory graphic showing this packaging return cycle: customer returns an empty jar, store inspects it, accepted jars are washed, clean jars are refilled. Use four large illustrated stages connected clockwise. Add only these exact labels: 'RETURN', 'INSPECT', 'WASH', 'REFILL'. Make the arrow direction and stage order unmistakable.One landscape image with four labeled stages and arrows matching the supplied cycle.Inspect that arrows connect RETURN to INSPECT to WASH to REFILL in that order, with exact labels.gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) — Google’ning murakkab dizayn, mahsulot maketlari va faktlarga asoslangan vizualizatsiyalar uchun mulohaza yuritishga tayanuvchi tasvir modeli. U matn va tasvir namunalarini qabul qiladi, tasvir va matn yaratadi hamda 1K–4K chiqish va batafsil ijodiy boshqaruvni taqdim etadi.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Nano Banana Pro — Google’ning mulohaza yuritishga tayangan tasvir yaratish va tahrirlash uchun Gemini 3 Pro Image modeli. Ishlab chiqaruvchi uning asosiy qo‘llanishlari markaziga murakkab grafik dizayn, asliga juda mos mahsulot maketlari va faktik ma’lumotlarni vizualizatsiya qilishni qo‘yadi. U matn va tasvirlarni qabul qiladi hamda tasvir va matn yaratadi. Ushbu nomlangan Pro tasvir nashri Gemini 3 Pro asosida yaratilgan bo‘lsa-da, tasvir vazifalari uchun o‘zining kirish va imkoniyatlar profilini saqlaydi.
Model 1K, 2K va 4K tasvirlarni qo‘llab-quvvatlaydi. Hujjatlashtirilgan shakllarga 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 va 21:9 kiradi. Kvadrat 4K tasvir 4096 × 4096; 16:9 nisbatdagi 4K tasvir esa 5504 × 3072. Portret poster, mahsulot sahnasi yoki keng tushuntiruvchi grafika bo‘lishidan qat’i nazar, aniqlik va tomonlar nisbatini kerakli materialga mos tanlang. Gemini 3.1 Flash Image’ning 0.5K varianti va qo‘shimcha keskin nisbatlari ushbu Pro jadvaliga kirmaydi.
Matnni tasvirga tushirish posterlar, diagrammalar va boshqa dizayn materiallarida aniq yozuvlarni qo‘llab-quvvatlaydi. Murakkab infografika uchun asosiy faktlar, aniq matn, o‘qish ketma-ketligi va yozuvlar bilan vizual elementlar o‘rtasidagi munosabatni bering. Yetkaziladigan ma’lumotni kerakli badiiy uslubdan ajrating. Google avval matnni tayyorlashni, keyin uni o‘z ichiga olgan tasvirni yaratishni tavsiya qiladi. Bu kompozitsiyada sarlavha, diagramma va bir nechta qisqa izoh birlashganda ayniqsa foydali.
Bir nechta tasvir kirishi 14 tagacha namunani qo‘llab-quvvatlaydi. Google imkoniyatlar jadvalida moslik uchun oltitagacha obyekt namunasi, izchillik uchun beshtagacha qahramon namunasi va uchtagacha uslub namunasi tavsiflangan. Bu vazifalar tarkibiy vizualni tayyorlashga yordam beradi: mahsulot fotosurati tashqi ko‘rinishni belgilaydi, alohida rasm muhitni beradi, uslub tasviri esa ishlov yo‘nalishini ko‘rsatadi. Har bir ko‘rinadigan xususiyatni farqlamasdan birlashtirishni so‘rash o‘rniga, qaysi tafsilotlar asosiy ishonchli manba va qaysi namunalar ilhom manbai ekanini modelga ayting.
Google Search orqali manbalarga asoslash faktik vizualizatsiya yoki dolzarb sharoitlarga tayangan sahna uchun haqiqiy dunyo ma’lumotlarini berishi mumkin. Pro tasvir ish jarayonida veb manbalariga asoslash hujjatlashtirilgan; Image Search kengaytmasi esa aynan Nano Banana 2.1 va Gemini 3.1 Flash Image uchun hujjatlashtirilgan. Ma’lumot grafikasida ko‘rsatmoqchi bo‘lgan qiymatlarni bering yoki ishlab chiqaruvchi ish jarayonida manbalarga asoslangan ma’lumotni so‘rang, so‘ng munosabat, yozuvlar va joylashuvni aniq qiling. Qidiruvga tayangan generatsiya baribir tekshiriladigan tasvir yaratadi va tasvirlangan faktlarni tekshirish o‘rnini bosmaydi.
Mulohaza yuritish yakuniy tasvirlashdan oldin murakkab prompt kompozitsiyasini tuzishga yordam beradi. Tasvir qo‘llanmasida kompozitsiya va mantiqni sinash uchun ishlatiladigan, yakuniy materialdan farqli oraliq tasvirlar tavsiflangan. Nano Banana 2’ning minimal/high boshqaruv jadvalini yoki Nano Banana 2.1’ning standart darajasi medium bo‘lgan jadvalini ushbu Pro nashriga ko‘chirmang. Talabchan dizayn uchun vizual iyerarxiya, obyektlar o‘rtasidagi zarur munosabatlar va keyingi tahrirlarda saqlanishi shart bo‘lgan elementlardan iborat to‘liq topshiriq bering.
Model kartasida hali mavjud bo‘lgan muhim cheklovlar tasvirlangan: juda mayda matn va uzun parchalar yomon chiqishi, qahramon tashqi ko‘rinishi namunadan natijagacha o‘zgarishi, niqobli yoki qoralama chizmalarga asoslangan tahrirlar esa ko‘rsatmaga faqat qisman rioya qilishi yoki iz qoldirishi mumkin. U chap va o‘ngni ham chalkashtirishi yoki manba elementini yangi kompozitsiyaga ko‘chirishi mumkin. Mahsulotni tahrirlashda saqlanadigan geometriya va yozuvlarni aniq ayting hamda tahrirlangan hududni tekshiring; diagrammada esa strelkalar yo‘nalishi va obyektlarning bir-biriga nisbatan joylashuvini solishtiring.
Amaldagi API jadvalida kirish chegarasi 65,536 token, chiqish chegarasi 32,768 token deb ko‘rsatilgan. Tasvir yaratish, fikrlash, qidiruv manbalari bilan asoslash va paketli ishlov qo‘llab-quvvatlanadi; audio yaratish, funksiya chaqirish, kod bajarish, keshlash, tuzilgan chiqishlar, fayl qidirish, URL konteksti va Live API qo‘llab-quvvatlanmaydi. Ushbu profildagi tasvir vazifasi audio ham, video kirishini ham qabul qilmaydi. Yaratilgan tasvirlarda SynthID bor, so‘ralgan chiqish tasvirlari soniga esa har doim aynan rioya qilinmaydi.
Amaliy mahsulot topshirig‘i mahsulot tasviri, yoritish namunasi va aniq sarlavhani birlashtirishi mumkin: “Mahsulot nisbatlari va yozuvlarini saqlang, uni yumshoq yon yorug‘lik ostidagi och rangli tosh sirtida ko‘rsating va yuqori uchdan bir qismini berilgan sarlavha uchun bo‘sh qoldiring.” Faktik diagramma uchun har bir obyekt va bog‘lanishni belgilang hamda tasdiqlangan yozuvlarni bering. Suhbatda bitta o‘zgarish va saqlanadigan xususiyatlarni aytib natijani takomillashtiring, tanlangan tasvir va uning izohlovchi matnini dizayn materiali sifatida birga saqlang.
POST /v1/images/generationstextimage| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar gemini-3-pro-image | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Eng kam uzunlik: 1 | Standart— |
Maydonn | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 | Standart1 |
Maydonresponse_format | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar url, b64_json | Standart— |
Maydonstream | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standartfalse |
Maydonsize | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonquality | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonbackground | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonoutput_format | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonoutput_compression | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonmoderation | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydoninput_fidelity | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonstyle | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonpartial_images | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Matndan rasm · Majburiy: prompt
| Parametr | Parametr talablari |
|---|---|
Parametrmaterial_types | Parametr talablaritext |
Parametrrequired | Parametr talablarimodel, prompt |
Parametroptional_controls | Parametr talablarinull |
Parametrcontent_type | Parametr talablariapplication/json |
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}
Metod tuzilishlari va IDlari aniq; yetkazib beruvchining imkoniyati so‘rovni qabul qilishga ruxsatdan alohida.
POST /v1/images/generationsAiloot 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 →
Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.
| Sozlama | Tariflar jadvali | To‘lov |
|---|---|---|
| SozlamaUltra | Tariflar jadvaliAsosiy tarif | To‘lov Kirish · Kirish tokenlari $0.004000 / 1K token Chiqish · Chiqish tokenlari $0.024000 / 1K token Kirish · rasm $0.004000 / 1K token Chiqish · rasm chiqishi $0.24000 / 1K token Kirish · audio $0.004000 / 1K token Kirish · Kirish audiosi keshi $0.0004000 / 1K token Chiqish · veb-qidiruv $0.028 internetda qidirish uchun Chiqish · Ichki mantiqiy fikrlash $0.024000 / 1K token Kirish · Keshdan o‘qish $0.0004000 / 1K token Kirish · Keshga yozish $0.000750000 / 1K token |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gemini-3-pro-image", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nfrom openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gemini-3-pro-image', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gemini-3-pro-image", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\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}Har bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.
Har bir ma’lumot elementini saqlang. Har bir b64_json ni dekodlang yoki qaytarilgan har bir imzolangan URL dan faylni yuklab oling. Fayl nomi kengaytmasini haqiqiy MIME turi/baytlar asosida tanlang.
Rasm yaratish yoki tahrirlash natijasini tekshirish kerak bo‘lsa, dastlabki operation_id/X-Client-Request-ID va qaytarilgan natija haqidagi ma’lumotlarni saqlang. Amalda qaytarilgan task_id yoki asset_id qiymatlari yordamida media kutubxonasidan o‘zingizga tegishli mavjud natijalarni tiklang. Rasm yaratish/tahrirlash so‘rovini qayta yubormang va operation_id dan holatni davriy tekshirish uchun URL tuzmang.
| Maydon | Tur |
|---|---|
Maydoncreated | Turinteger |
Maydondata[].url | Turstring |
Maydondata[].b64_json | Turbase64 string |
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. |
Javobserver_error | ShartQaytarilgan javob operatsiya yoki natijani tekshirish kerakligini bildiradi | Keyingi qadamDastlab qaytarilgan operatsiya/vazifa ID sini, so‘rov sarlavhalarini va javobni saqlang; aynan shu operatsiya uchun qo‘llab-quvvatlanadigan o‘qish so‘rovlarini davom ettiring. Yaratish so‘rovini qayta yubormang. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
gemini-3-pro-image-previewNano Banana Pro (Gemini 3 Pro Image) — Google’ning murakkab dizayn, mahsulot maketlari va faktlarga asoslangan vizualizatsiyalar uchun mulohaza yuritishga tayanuvchi tasvir modeli. U matn va tasvir namunalarini qabul qiladi, tasvir va matn yaratadi hamda 1K–4K chiqish va batafsil ijodiy boshqaruvni taqdim etadi.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Nano Banana Pro — Google’ning mulohaza yuritishga tayangan tasvir yaratish va tahrirlash uchun Gemini 3 Pro Image modeli. Ishlab chiqaruvchi uning asosiy qo‘llanishlari markaziga murakkab grafik dizayn, asliga juda mos mahsulot maketlari va faktik ma’lumotlarni vizualizatsiya qilishni qo‘yadi. U matn va tasvirlarni qabul qiladi hamda tasvir va matn yaratadi. Ushbu nomlangan Pro tasvir nashri Gemini 3 Pro asosida yaratilgan bo‘lsa-da, tasvir vazifalari uchun o‘zining kirish va imkoniyatlar profilini saqlaydi.
Model 1K, 2K va 4K tasvirlarni qo‘llab-quvvatlaydi. Hujjatlashtirilgan shakllarga 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 va 21:9 kiradi. Kvadrat 4K tasvir 4096 × 4096; 16:9 nisbatdagi 4K tasvir esa 5504 × 3072. Portret poster, mahsulot sahnasi yoki keng tushuntiruvchi grafika bo‘lishidan qat’i nazar, aniqlik va tomonlar nisbatini kerakli materialga mos tanlang. Gemini 3.1 Flash Image’ning 0.5K varianti va qo‘shimcha keskin nisbatlari ushbu Pro jadvaliga kirmaydi.
Matnni tasvirga tushirish posterlar, diagrammalar va boshqa dizayn materiallarida aniq yozuvlarni qo‘llab-quvvatlaydi. Murakkab infografika uchun asosiy faktlar, aniq matn, o‘qish ketma-ketligi va yozuvlar bilan vizual elementlar o‘rtasidagi munosabatni bering. Yetkaziladigan ma’lumotni kerakli badiiy uslubdan ajrating. Google avval matnni tayyorlashni, keyin uni o‘z ichiga olgan tasvirni yaratishni tavsiya qiladi. Bu kompozitsiyada sarlavha, diagramma va bir nechta qisqa izoh birlashganda ayniqsa foydali.
Bir nechta tasvir kirishi 14 tagacha namunani qo‘llab-quvvatlaydi. Google imkoniyatlar jadvalida moslik uchun oltitagacha obyekt namunasi, izchillik uchun beshtagacha qahramon namunasi va uchtagacha uslub namunasi tavsiflangan. Bu vazifalar tarkibiy vizualni tayyorlashga yordam beradi: mahsulot fotosurati tashqi ko‘rinishni belgilaydi, alohida rasm muhitni beradi, uslub tasviri esa ishlov yo‘nalishini ko‘rsatadi. Har bir ko‘rinadigan xususiyatni farqlamasdan birlashtirishni so‘rash o‘rniga, qaysi tafsilotlar asosiy ishonchli manba va qaysi namunalar ilhom manbai ekanini modelga ayting.
Google Search orqali manbalarga asoslash faktik vizualizatsiya yoki dolzarb sharoitlarga tayangan sahna uchun haqiqiy dunyo ma’lumotlarini berishi mumkin. Pro tasvir ish jarayonida veb manbalariga asoslash hujjatlashtirilgan; Image Search kengaytmasi esa aynan Nano Banana 2.1 va Gemini 3.1 Flash Image uchun hujjatlashtirilgan. Ma’lumot grafikasida ko‘rsatmoqchi bo‘lgan qiymatlarni bering yoki ishlab chiqaruvchi ish jarayonida manbalarga asoslangan ma’lumotni so‘rang, so‘ng munosabat, yozuvlar va joylashuvni aniq qiling. Qidiruvga tayangan generatsiya baribir tekshiriladigan tasvir yaratadi va tasvirlangan faktlarni tekshirish o‘rnini bosmaydi.
Mulohaza yuritish yakuniy tasvirlashdan oldin murakkab prompt kompozitsiyasini tuzishga yordam beradi. Tasvir qo‘llanmasida kompozitsiya va mantiqni sinash uchun ishlatiladigan, yakuniy materialdan farqli oraliq tasvirlar tavsiflangan. Nano Banana 2’ning minimal/high boshqaruv jadvalini yoki Nano Banana 2.1’ning standart darajasi medium bo‘lgan jadvalini ushbu Pro nashriga ko‘chirmang. Talabchan dizayn uchun vizual iyerarxiya, obyektlar o‘rtasidagi zarur munosabatlar va keyingi tahrirlarda saqlanishi shart bo‘lgan elementlardan iborat to‘liq topshiriq bering.
Model kartasida hali mavjud bo‘lgan muhim cheklovlar tasvirlangan: juda mayda matn va uzun parchalar yomon chiqishi, qahramon tashqi ko‘rinishi namunadan natijagacha o‘zgarishi, niqobli yoki qoralama chizmalarga asoslangan tahrirlar esa ko‘rsatmaga faqat qisman rioya qilishi yoki iz qoldirishi mumkin. U chap va o‘ngni ham chalkashtirishi yoki manba elementini yangi kompozitsiyaga ko‘chirishi mumkin. Mahsulotni tahrirlashda saqlanadigan geometriya va yozuvlarni aniq ayting hamda tahrirlangan hududni tekshiring; diagrammada esa strelkalar yo‘nalishi va obyektlarning bir-biriga nisbatan joylashuvini solishtiring.
Amaldagi API jadvalida kirish chegarasi 65,536 token, chiqish chegarasi 32,768 token deb ko‘rsatilgan. Tasvir yaratish, fikrlash, qidiruv manbalari bilan asoslash va paketli ishlov qo‘llab-quvvatlanadi; audio yaratish, funksiya chaqirish, kod bajarish, keshlash, tuzilgan chiqishlar, fayl qidirish, URL konteksti va Live API qo‘llab-quvvatlanmaydi. Ushbu profildagi tasvir vazifasi audio ham, video kirishini ham qabul qilmaydi. Yaratilgan tasvirlarda SynthID bor, so‘ralgan chiqish tasvirlari soniga esa har doim aynan rioya qilinmaydi.
Amaliy mahsulot topshirig‘i mahsulot tasviri, yoritish namunasi va aniq sarlavhani birlashtirishi mumkin: “Mahsulot nisbatlari va yozuvlarini saqlang, uni yumshoq yon yorug‘lik ostidagi och rangli tosh sirtida ko‘rsating va yuqori uchdan bir qismini berilgan sarlavha uchun bo‘sh qoldiring.” Faktik diagramma uchun har bir obyekt va bog‘lanishni belgilang hamda tasdiqlangan yozuvlarni bering. Suhbatda bitta o‘zgarish va saqlanadigan xususiyatlarni aytib natijani takomillashtiring, tanlangan tasvir va uning izohlovchi matnini dizayn materiali sifatida birga saqlang.
POST /v1/images/generationstextimage| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar gemini-3-pro-image-preview | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Eng kam uzunlik: 1 | Standart— |
Maydonn | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 | Standart1 |
Maydonresponse_format | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar url, b64_json | Standart— |
Maydonstream | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standartfalse |
Maydonsize | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonquality | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonbackground | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonoutput_format | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonoutput_compression | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonmoderation | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydoninput_fidelity | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonstyle | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonpartial_images | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Matndan rasm · Majburiy: prompt
| Parametr | Parametr talablari |
|---|---|
Parametrmaterial_types | Parametr talablaritext |
Parametrrequired | Parametr talablarimodel, prompt |
Parametroptional_controls | Parametr talablarinull |
Parametrcontent_type | Parametr talablariapplication/json |
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}
Metod tuzilishlari va IDlari aniq; yetkazib beruvchining imkoniyati so‘rovni qabul qilishga ruxsatdan alohida.
POST /v1/images/generationsAiloot 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 →
Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.
| Sozlama | Tariflar jadvali | To‘lov |
|---|---|---|
| SozlamaUltra | Tariflar jadvaliAsosiy tarif | To‘lov Kirish · Kirish tokenlari $0.004000 / 1K token Chiqish · Chiqish tokenlari $0.024000 / 1K token Kirish · rasm $0.004000 / 1K token Chiqish · rasm chiqishi $0.24000 / 1K token Kirish · audio $0.004000 / 1K token Kirish · Kirish audiosi keshi $0.0004000 / 1K token Chiqish · veb-qidiruv $0.028 internetda qidirish uchun Chiqish · Ichki mantiqiy fikrlash $0.024000 / 1K token Kirish · Keshdan o‘qish $0.0004000 / 1K token Kirish · Keshga yozish $0.000750000 / 1K token |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gemini-3-pro-image-preview", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nfrom openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gemini-3-pro-image-preview', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gemini-3-pro-image-preview", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\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}Har bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.
Har bir ma’lumot elementini saqlang. Har bir b64_json ni dekodlang yoki qaytarilgan har bir imzolangan URL dan faylni yuklab oling. Fayl nomi kengaytmasini haqiqiy MIME turi/baytlar asosida tanlang.
Rasm yaratish yoki tahrirlash natijasini tekshirish kerak bo‘lsa, dastlabki operation_id/X-Client-Request-ID va qaytarilgan natija haqidagi ma’lumotlarni saqlang. Amalda qaytarilgan task_id yoki asset_id qiymatlari yordamida media kutubxonasidan o‘zingizga tegishli mavjud natijalarni tiklang. Rasm yaratish/tahrirlash so‘rovini qayta yubormang va operation_id dan holatni davriy tekshirish uchun URL tuzmang.
| Maydon | Tur |
|---|---|
Maydoncreated | Turinteger |
Maydondata[].url | Turstring |
Maydondata[].b64_json | Turbase64 string |
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. |
Javobserver_error | ShartQaytarilgan javob operatsiya yoki natijani tekshirish kerakligini bildiradi | Keyingi qadamDastlab qaytarilgan operatsiya/vazifa ID sini, so‘rov sarlavhalarini va javobni saqlang; aynan shu operatsiya uchun qo‘llab-quvvatlanadigan o‘qish so‘rovlarini davom ettiring. Yaratish so‘rovini qayta yubormang. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
nano-banana-proNano Banana Pro (Gemini 3 Pro Image) — Google’ning murakkab dizayn, mahsulot maketlari va faktlarga asoslangan vizualizatsiyalar uchun mulohaza yuritishga tayanuvchi tasvir modeli. U matn va tasvir namunalarini qabul qiladi, tasvir va matn yaratadi hamda 1K–4K chiqish va batafsil ijodiy boshqaruvni taqdim etadi.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Nano Banana Pro — Google’ning mulohaza yuritishga tayangan tasvir yaratish va tahrirlash uchun Gemini 3 Pro Image modeli. Ishlab chiqaruvchi uning asosiy qo‘llanishlari markaziga murakkab grafik dizayn, asliga juda mos mahsulot maketlari va faktik ma’lumotlarni vizualizatsiya qilishni qo‘yadi. U matn va tasvirlarni qabul qiladi hamda tasvir va matn yaratadi. Ushbu nomlangan Pro tasvir nashri Gemini 3 Pro asosida yaratilgan bo‘lsa-da, tasvir vazifalari uchun o‘zining kirish va imkoniyatlar profilini saqlaydi.
Model 1K, 2K va 4K tasvirlarni qo‘llab-quvvatlaydi. Hujjatlashtirilgan shakllarga 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 va 21:9 kiradi. Kvadrat 4K tasvir 4096 × 4096; 16:9 nisbatdagi 4K tasvir esa 5504 × 3072. Portret poster, mahsulot sahnasi yoki keng tushuntiruvchi grafika bo‘lishidan qat’i nazar, aniqlik va tomonlar nisbatini kerakli materialga mos tanlang. Gemini 3.1 Flash Image’ning 0.5K varianti va qo‘shimcha keskin nisbatlari ushbu Pro jadvaliga kirmaydi.
Matnni tasvirga tushirish posterlar, diagrammalar va boshqa dizayn materiallarida aniq yozuvlarni qo‘llab-quvvatlaydi. Murakkab infografika uchun asosiy faktlar, aniq matn, o‘qish ketma-ketligi va yozuvlar bilan vizual elementlar o‘rtasidagi munosabatni bering. Yetkaziladigan ma’lumotni kerakli badiiy uslubdan ajrating. Google avval matnni tayyorlashni, keyin uni o‘z ichiga olgan tasvirni yaratishni tavsiya qiladi. Bu kompozitsiyada sarlavha, diagramma va bir nechta qisqa izoh birlashganda ayniqsa foydali.
Bir nechta tasvir kirishi 14 tagacha namunani qo‘llab-quvvatlaydi. Google imkoniyatlar jadvalida moslik uchun oltitagacha obyekt namunasi, izchillik uchun beshtagacha qahramon namunasi va uchtagacha uslub namunasi tavsiflangan. Bu vazifalar tarkibiy vizualni tayyorlashga yordam beradi: mahsulot fotosurati tashqi ko‘rinishni belgilaydi, alohida rasm muhitni beradi, uslub tasviri esa ishlov yo‘nalishini ko‘rsatadi. Har bir ko‘rinadigan xususiyatni farqlamasdan birlashtirishni so‘rash o‘rniga, qaysi tafsilotlar asosiy ishonchli manba va qaysi namunalar ilhom manbai ekanini modelga ayting.
Google Search orqali manbalarga asoslash faktik vizualizatsiya yoki dolzarb sharoitlarga tayangan sahna uchun haqiqiy dunyo ma’lumotlarini berishi mumkin. Pro tasvir ish jarayonida veb manbalariga asoslash hujjatlashtirilgan; Image Search kengaytmasi esa aynan Nano Banana 2.1 va Gemini 3.1 Flash Image uchun hujjatlashtirilgan. Ma’lumot grafikasida ko‘rsatmoqchi bo‘lgan qiymatlarni bering yoki ishlab chiqaruvchi ish jarayonida manbalarga asoslangan ma’lumotni so‘rang, so‘ng munosabat, yozuvlar va joylashuvni aniq qiling. Qidiruvga tayangan generatsiya baribir tekshiriladigan tasvir yaratadi va tasvirlangan faktlarni tekshirish o‘rnini bosmaydi.
Mulohaza yuritish yakuniy tasvirlashdan oldin murakkab prompt kompozitsiyasini tuzishga yordam beradi. Tasvir qo‘llanmasida kompozitsiya va mantiqni sinash uchun ishlatiladigan, yakuniy materialdan farqli oraliq tasvirlar tavsiflangan. Nano Banana 2’ning minimal/high boshqaruv jadvalini yoki Nano Banana 2.1’ning standart darajasi medium bo‘lgan jadvalini ushbu Pro nashriga ko‘chirmang. Talabchan dizayn uchun vizual iyerarxiya, obyektlar o‘rtasidagi zarur munosabatlar va keyingi tahrirlarda saqlanishi shart bo‘lgan elementlardan iborat to‘liq topshiriq bering.
Model kartasida hali mavjud bo‘lgan muhim cheklovlar tasvirlangan: juda mayda matn va uzun parchalar yomon chiqishi, qahramon tashqi ko‘rinishi namunadan natijagacha o‘zgarishi, niqobli yoki qoralama chizmalarga asoslangan tahrirlar esa ko‘rsatmaga faqat qisman rioya qilishi yoki iz qoldirishi mumkin. U chap va o‘ngni ham chalkashtirishi yoki manba elementini yangi kompozitsiyaga ko‘chirishi mumkin. Mahsulotni tahrirlashda saqlanadigan geometriya va yozuvlarni aniq ayting hamda tahrirlangan hududni tekshiring; diagrammada esa strelkalar yo‘nalishi va obyektlarning bir-biriga nisbatan joylashuvini solishtiring.
Amaldagi API jadvalida kirish chegarasi 65,536 token, chiqish chegarasi 32,768 token deb ko‘rsatilgan. Tasvir yaratish, fikrlash, qidiruv manbalari bilan asoslash va paketli ishlov qo‘llab-quvvatlanadi; audio yaratish, funksiya chaqirish, kod bajarish, keshlash, tuzilgan chiqishlar, fayl qidirish, URL konteksti va Live API qo‘llab-quvvatlanmaydi. Ushbu profildagi tasvir vazifasi audio ham, video kirishini ham qabul qilmaydi. Yaratilgan tasvirlarda SynthID bor, so‘ralgan chiqish tasvirlari soniga esa har doim aynan rioya qilinmaydi.
Amaliy mahsulot topshirig‘i mahsulot tasviri, yoritish namunasi va aniq sarlavhani birlashtirishi mumkin: “Mahsulot nisbatlari va yozuvlarini saqlang, uni yumshoq yon yorug‘lik ostidagi och rangli tosh sirtida ko‘rsating va yuqori uchdan bir qismini berilgan sarlavha uchun bo‘sh qoldiring.” Faktik diagramma uchun har bir obyekt va bog‘lanishni belgilang hamda tasdiqlangan yozuvlarni bering. Suhbatda bitta o‘zgarish va saqlanadigan xususiyatlarni aytib natijani takomillashtiring, tanlangan tasvir va uning izohlovchi matnini dizayn materiali sifatida birga saqlang.
POST /v1/images/generationstextimage| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar nano-banana-pro | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Eng kam uzunlik: 1 | Standart— |
Maydonn | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: 1 | Standart1 |
Maydonresponse_format | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar url, b64_json | Standart— |
Maydonstream | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standartfalse |
Maydonsize | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonquality | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonbackground | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonoutput_format | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonoutput_compression | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonmoderation | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydoninput_fidelity | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonstyle | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Maydonpartial_images | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Modelga bogʻliq | Standart— |
Matndan rasm · Majburiy: prompt
| Parametr | Parametr talablari |
|---|---|
Parametrmaterial_types | Parametr talablaritext |
Parametrrequired | Parametr talablarimodel, prompt |
Parametroptional_controls | Parametr talablarinull |
Parametrcontent_type | Parametr talablariapplication/json |
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}
Metod tuzilishlari va IDlari aniq; yetkazib beruvchining imkoniyati so‘rovni qabul qilishga ruxsatdan alohida.
POST /v1/images/generationsAiloot 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 →
Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.
| Sozlama | Tariflar jadvali | To‘lov |
|---|---|---|
| SozlamaUltra | Tariflar jadvaliAsosiy tarif | To‘lov Kirish · Kirish tokenlari $0.004000 / 1K token Chiqish · Chiqish tokenlari $0.024000 / 1K token Kirish · rasm $0.004000 / 1K token Chiqish · rasm chiqishi $0.24000 / 1K token Kirish · audio $0.004000 / 1K token Kirish · Kirish audiosi keshi $0.0004000 / 1K token Chiqish · veb-qidiruv $0.028 internetda qidirish uchun Chiqish · Ichki mantiqiy fikrlash $0.024000 / 1K token Kirish · Keshdan o‘qish $0.0004000 / 1K token Kirish · Keshga yozish $0.000750000 / 1K token |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "nano-banana-pro", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nfrom openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'nano-banana-pro', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "nano-banana-pro", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\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}Har bir tayyor rasmni saqlang; har bir qaytarilgan URL dan kontentni oling yoki uning Base64 kontentini dekodlang.
Har bir ma’lumot elementini saqlang. Har bir b64_json ni dekodlang yoki qaytarilgan har bir imzolangan URL dan faylni yuklab oling. Fayl nomi kengaytmasini haqiqiy MIME turi/baytlar asosida tanlang.
Rasm yaratish yoki tahrirlash natijasini tekshirish kerak bo‘lsa, dastlabki operation_id/X-Client-Request-ID va qaytarilgan natija haqidagi ma’lumotlarni saqlang. Amalda qaytarilgan task_id yoki asset_id qiymatlari yordamida media kutubxonasidan o‘zingizga tegishli mavjud natijalarni tiklang. Rasm yaratish/tahrirlash so‘rovini qayta yubormang va operation_id dan holatni davriy tekshirish uchun URL tuzmang.
| Maydon | Tur |
|---|---|
Maydoncreated | Turinteger |
Maydondata[].url | Turstring |
Maydondata[].b64_json | Turbase64 string |
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. |
Javobserver_error | ShartQaytarilgan javob operatsiya yoki natijani tekshirish kerakligini bildiradi | Keyingi qadamDastlab qaytarilgan operatsiya/vazifa ID sini, so‘rov sarlavhalarini va javobni saqlang; aynan shu operatsiya uchun qo‘llab-quvvatlanadigan o‘qish so‘rovlarini davom ettiring. Yaratish so‘rovini qayta yubormang. |
Ailoot gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) — Google’ning murakkab dizayn, mahsulot maketlari va faktlarga asoslangan vizualizatsiyalar uchun mulohaza yuritishga tayanuvchi tasvir modeli. U matn va tasvir namunalarini qabul qiladi, tasvir va matn yaratadi hamda 1K–4K chiqish va batafsil ijodiy boshqaruvni taqdim etadi.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Nano Banana Pro — Google’ning mulohaza yuritishga tayangan tasvir yaratish va tahrirlash uchun Gemini 3 Pro Image modeli. Ishlab chiqaruvchi uning asosiy qo‘llanishlari markaziga murakkab grafik dizayn, asliga juda mos mahsulot maketlari va faktik ma’lumotlarni vizualizatsiya qilishni qo‘yadi. U matn va tasvirlarni qabul qiladi hamda tasvir va matn yaratadi. Ushbu nomlangan Pro tasvir nashri Gemini 3 Pro asosida yaratilgan bo‘lsa-da, tasvir vazifalari uchun o‘zining kirish va imkoniyatlar profilini saqlaydi.
Model 1K, 2K va 4K tasvirlarni qo‘llab-quvvatlaydi. Hujjatlashtirilgan shakllarga 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 va 21:9 kiradi. Kvadrat 4K tasvir 4096 × 4096; 16:9 nisbatdagi 4K tasvir esa 5504 × 3072. Portret poster, mahsulot sahnasi yoki keng tushuntiruvchi grafika bo‘lishidan qat’i nazar, aniqlik va tomonlar nisbatini kerakli materialga mos tanlang. Gemini 3.1 Flash Image’ning 0.5K varianti va qo‘shimcha keskin nisbatlari ushbu Pro jadvaliga kirmaydi.
Matnni tasvirga tushirish posterlar, diagrammalar va boshqa dizayn materiallarida aniq yozuvlarni qo‘llab-quvvatlaydi. Murakkab infografika uchun asosiy faktlar, aniq matn, o‘qish ketma-ketligi va yozuvlar bilan vizual elementlar o‘rtasidagi munosabatni bering. Yetkaziladigan ma’lumotni kerakli badiiy uslubdan ajrating. Google avval matnni tayyorlashni, keyin uni o‘z ichiga olgan tasvirni yaratishni tavsiya qiladi. Bu kompozitsiyada sarlavha, diagramma va bir nechta qisqa izoh birlashganda ayniqsa foydali.
Bir nechta tasvir kirishi 14 tagacha namunani qo‘llab-quvvatlaydi. Google imkoniyatlar jadvalida moslik uchun oltitagacha obyekt namunasi, izchillik uchun beshtagacha qahramon namunasi va uchtagacha uslub namunasi tavsiflangan. Bu vazifalar tarkibiy vizualni tayyorlashga yordam beradi: mahsulot fotosurati tashqi ko‘rinishni belgilaydi, alohida rasm muhitni beradi, uslub tasviri esa ishlov yo‘nalishini ko‘rsatadi. Har bir ko‘rinadigan xususiyatni farqlamasdan birlashtirishni so‘rash o‘rniga, qaysi tafsilotlar asosiy ishonchli manba va qaysi namunalar ilhom manbai ekanini modelga ayting.
Google Search orqali manbalarga asoslash faktik vizualizatsiya yoki dolzarb sharoitlarga tayangan sahna uchun haqiqiy dunyo ma’lumotlarini berishi mumkin. Pro tasvir ish jarayonida veb manbalariga asoslash hujjatlashtirilgan; Image Search kengaytmasi esa aynan Nano Banana 2.1 va Gemini 3.1 Flash Image uchun hujjatlashtirilgan. Ma’lumot grafikasida ko‘rsatmoqchi bo‘lgan qiymatlarni bering yoki ishlab chiqaruvchi ish jarayonida manbalarga asoslangan ma’lumotni so‘rang, so‘ng munosabat, yozuvlar va joylashuvni aniq qiling. Qidiruvga tayangan generatsiya baribir tekshiriladigan tasvir yaratadi va tasvirlangan faktlarni tekshirish o‘rnini bosmaydi.
Mulohaza yuritish yakuniy tasvirlashdan oldin murakkab prompt kompozitsiyasini tuzishga yordam beradi. Tasvir qo‘llanmasida kompozitsiya va mantiqni sinash uchun ishlatiladigan, yakuniy materialdan farqli oraliq tasvirlar tavsiflangan. Nano Banana 2’ning minimal/high boshqaruv jadvalini yoki Nano Banana 2.1’ning standart darajasi medium bo‘lgan jadvalini ushbu Pro nashriga ko‘chirmang. Talabchan dizayn uchun vizual iyerarxiya, obyektlar o‘rtasidagi zarur munosabatlar va keyingi tahrirlarda saqlanishi shart bo‘lgan elementlardan iborat to‘liq topshiriq bering.
Model kartasida hali mavjud bo‘lgan muhim cheklovlar tasvirlangan: juda mayda matn va uzun parchalar yomon chiqishi, qahramon tashqi ko‘rinishi namunadan natijagacha o‘zgarishi, niqobli yoki qoralama chizmalarga asoslangan tahrirlar esa ko‘rsatmaga faqat qisman rioya qilishi yoki iz qoldirishi mumkin. U chap va o‘ngni ham chalkashtirishi yoki manba elementini yangi kompozitsiyaga ko‘chirishi mumkin. Mahsulotni tahrirlashda saqlanadigan geometriya va yozuvlarni aniq ayting hamda tahrirlangan hududni tekshiring; diagrammada esa strelkalar yo‘nalishi va obyektlarning bir-biriga nisbatan joylashuvini solishtiring.
Amaldagi API jadvalida kirish chegarasi 65,536 token, chiqish chegarasi 32,768 token deb ko‘rsatilgan. Tasvir yaratish, fikrlash, qidiruv manbalari bilan asoslash va paketli ishlov qo‘llab-quvvatlanadi; audio yaratish, funksiya chaqirish, kod bajarish, keshlash, tuzilgan chiqishlar, fayl qidirish, URL konteksti va Live API qo‘llab-quvvatlanmaydi. Ushbu profildagi tasvir vazifasi audio ham, video kirishini ham qabul qilmaydi. Yaratilgan tasvirlarda SynthID bor, so‘ralgan chiqish tasvirlari soniga esa har doim aynan rioya qilinmaydi.
Amaliy mahsulot topshirig‘i mahsulot tasviri, yoritish namunasi va aniq sarlavhani birlashtirishi mumkin: “Mahsulot nisbatlari va yozuvlarini saqlang, uni yumshoq yon yorug‘lik ostidagi och rangli tosh sirtida ko‘rsating va yuqori uchdan bir qismini berilgan sarlavha uchun bo‘sh qoldiring.” Faktik diagramma uchun har bir obyekt va bog‘lanishni belgilang hamda tasdiqlangan yozuvlarni bering. Suhbatda bitta o‘zgarish va saqlanadigan xususiyatlarni aytib natijani takomillashtiring, tanlangan tasvir va uning izohlovchi matnini dizayn materiali sifatida birga saqlang.
POST /v1/chat/completionstexttext| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar google/gemini-3-pro-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.004 / 1K token Chiqish · Chiqish tokenlari $0.024 / 1K token Kirish · Keshdan o‘qish $0.0004 / 1K token Kirish · Keshga yozish $0.00075 / 1K token Kirish · Keshga yozish, 1 soat — / 1K token Chiqish · Chiqish rasmi tokenlari $0.24 / 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.004 / 1K token Chiqish · Chiqish tokenlari $0.024 / 1K token Kirish · Keshdan o‘qish $0.0004 / 1K token Kirish · Keshga yozish $0.00075 / 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: Nano Banana Pro (Gemini 3 Pro Image) · Standart sozlama | To‘lovni hisoblash shartlariStandart konfiguratsiya | To‘lov Kirish · Kirish tokenlari 0,004 US$ / 1K token Chiqish · Chiqish tokenlari 0,024 US$ / 1K token Kirish · Kirish rasmi 0,004 US$ / 1K token Chiqish · Chiqish rasmi 0,24 US$ / 1K token Kirish · Kirish audiosi 0,004 US$ / 1K token Kirish · Audio keshini o‘qish 0,0004 US$ / 1K token Chiqish · Veb-qidiruv 0,028 US$ har bir qidiruv uchun Chiqish · Mantiqiy fikrlash tokenlari 0,024 US$ / 1K token Kirish · Keshdan o‘qish 0,0004 US$ / 1K token Kirish · Keshga yozish · 5 daqiqa 0,00075 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-3-pro-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-3-pro-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-3-pro-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 gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) — Google’ning murakkab dizayn, mahsulot maketlari va faktlarga asoslangan vizualizatsiyalar uchun mulohaza yuritishga tayanuvchi tasvir modeli. U matn va tasvir namunalarini qabul qiladi, tasvir va matn yaratadi hamda 1K–4K chiqish va batafsil ijodiy boshqaruvni taqdim etadi.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Nano Banana Pro — Google’ning mulohaza yuritishga tayangan tasvir yaratish va tahrirlash uchun Gemini 3 Pro Image modeli. Ishlab chiqaruvchi uning asosiy qo‘llanishlari markaziga murakkab grafik dizayn, asliga juda mos mahsulot maketlari va faktik ma’lumotlarni vizualizatsiya qilishni qo‘yadi. U matn va tasvirlarni qabul qiladi hamda tasvir va matn yaratadi. Ushbu nomlangan Pro tasvir nashri Gemini 3 Pro asosida yaratilgan bo‘lsa-da, tasvir vazifalari uchun o‘zining kirish va imkoniyatlar profilini saqlaydi.
Model 1K, 2K va 4K tasvirlarni qo‘llab-quvvatlaydi. Hujjatlashtirilgan shakllarga 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 va 21:9 kiradi. Kvadrat 4K tasvir 4096 × 4096; 16:9 nisbatdagi 4K tasvir esa 5504 × 3072. Portret poster, mahsulot sahnasi yoki keng tushuntiruvchi grafika bo‘lishidan qat’i nazar, aniqlik va tomonlar nisbatini kerakli materialga mos tanlang. Gemini 3.1 Flash Image’ning 0.5K varianti va qo‘shimcha keskin nisbatlari ushbu Pro jadvaliga kirmaydi.
Matnni tasvirga tushirish posterlar, diagrammalar va boshqa dizayn materiallarida aniq yozuvlarni qo‘llab-quvvatlaydi. Murakkab infografika uchun asosiy faktlar, aniq matn, o‘qish ketma-ketligi va yozuvlar bilan vizual elementlar o‘rtasidagi munosabatni bering. Yetkaziladigan ma’lumotni kerakli badiiy uslubdan ajrating. Google avval matnni tayyorlashni, keyin uni o‘z ichiga olgan tasvirni yaratishni tavsiya qiladi. Bu kompozitsiyada sarlavha, diagramma va bir nechta qisqa izoh birlashganda ayniqsa foydali.
Bir nechta tasvir kirishi 14 tagacha namunani qo‘llab-quvvatlaydi. Google imkoniyatlar jadvalida moslik uchun oltitagacha obyekt namunasi, izchillik uchun beshtagacha qahramon namunasi va uchtagacha uslub namunasi tavsiflangan. Bu vazifalar tarkibiy vizualni tayyorlashga yordam beradi: mahsulot fotosurati tashqi ko‘rinishni belgilaydi, alohida rasm muhitni beradi, uslub tasviri esa ishlov yo‘nalishini ko‘rsatadi. Har bir ko‘rinadigan xususiyatni farqlamasdan birlashtirishni so‘rash o‘rniga, qaysi tafsilotlar asosiy ishonchli manba va qaysi namunalar ilhom manbai ekanini modelga ayting.
Google Search orqali manbalarga asoslash faktik vizualizatsiya yoki dolzarb sharoitlarga tayangan sahna uchun haqiqiy dunyo ma’lumotlarini berishi mumkin. Pro tasvir ish jarayonida veb manbalariga asoslash hujjatlashtirilgan; Image Search kengaytmasi esa aynan Nano Banana 2.1 va Gemini 3.1 Flash Image uchun hujjatlashtirilgan. Ma’lumot grafikasida ko‘rsatmoqchi bo‘lgan qiymatlarni bering yoki ishlab chiqaruvchi ish jarayonida manbalarga asoslangan ma’lumotni so‘rang, so‘ng munosabat, yozuvlar va joylashuvni aniq qiling. Qidiruvga tayangan generatsiya baribir tekshiriladigan tasvir yaratadi va tasvirlangan faktlarni tekshirish o‘rnini bosmaydi.
Mulohaza yuritish yakuniy tasvirlashdan oldin murakkab prompt kompozitsiyasini tuzishga yordam beradi. Tasvir qo‘llanmasida kompozitsiya va mantiqni sinash uchun ishlatiladigan, yakuniy materialdan farqli oraliq tasvirlar tavsiflangan. Nano Banana 2’ning minimal/high boshqaruv jadvalini yoki Nano Banana 2.1’ning standart darajasi medium bo‘lgan jadvalini ushbu Pro nashriga ko‘chirmang. Talabchan dizayn uchun vizual iyerarxiya, obyektlar o‘rtasidagi zarur munosabatlar va keyingi tahrirlarda saqlanishi shart bo‘lgan elementlardan iborat to‘liq topshiriq bering.
Model kartasida hali mavjud bo‘lgan muhim cheklovlar tasvirlangan: juda mayda matn va uzun parchalar yomon chiqishi, qahramon tashqi ko‘rinishi namunadan natijagacha o‘zgarishi, niqobli yoki qoralama chizmalarga asoslangan tahrirlar esa ko‘rsatmaga faqat qisman rioya qilishi yoki iz qoldirishi mumkin. U chap va o‘ngni ham chalkashtirishi yoki manba elementini yangi kompozitsiyaga ko‘chirishi mumkin. Mahsulotni tahrirlashda saqlanadigan geometriya va yozuvlarni aniq ayting hamda tahrirlangan hududni tekshiring; diagrammada esa strelkalar yo‘nalishi va obyektlarning bir-biriga nisbatan joylashuvini solishtiring.
Amaldagi API jadvalida kirish chegarasi 65,536 token, chiqish chegarasi 32,768 token deb ko‘rsatilgan. Tasvir yaratish, fikrlash, qidiruv manbalari bilan asoslash va paketli ishlov qo‘llab-quvvatlanadi; audio yaratish, funksiya chaqirish, kod bajarish, keshlash, tuzilgan chiqishlar, fayl qidirish, URL konteksti va Live API qo‘llab-quvvatlanmaydi. Ushbu profildagi tasvir vazifasi audio ham, video kirishini ham qabul qilmaydi. Yaratilgan tasvirlarda SynthID bor, so‘ralgan chiqish tasvirlari soniga esa har doim aynan rioya qilinmaydi.
Amaliy mahsulot topshirig‘i mahsulot tasviri, yoritish namunasi va aniq sarlavhani birlashtirishi mumkin: “Mahsulot nisbatlari va yozuvlarini saqlang, uni yumshoq yon yorug‘lik ostidagi och rangli tosh sirtida ko‘rsating va yuqori uchdan bir qismini berilgan sarlavha uchun bo‘sh qoldiring.” Faktik diagramma uchun har bir obyekt va bog‘lanishni belgilang hamda tasdiqlangan yozuvlarni bering. Suhbatda bitta o‘zgarish va saqlanadigan xususiyatlarni aytib natijani takomillashtiring, tanlangan tasvir va uning izohlovchi matnini dizayn materiali sifatida birga saqlang.
POST /v1/images/generationstext, imageimage| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar google/gemini-3-pro-image | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar Eng kam uzunlik: 1 | Standart— |
Maydonresolution | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 1K, 2K, 4K | 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: 14 | 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.98304 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-3-pro-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 gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
google/gemini-3-pro-imageNano Banana Pro (Gemini 3 Pro Image) — Google’ning murakkab dizayn, mahsulot maketlari va faktlarga asoslangan vizualizatsiyalar uchun mulohaza yuritishga tayanuvchi tasvir modeli. U matn va tasvir namunalarini qabul qiladi, tasvir va matn yaratadi hamda 1K–4K chiqish va batafsil ijodiy boshqaruvni taqdim etadi.
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
Nano Banana Pro — Google’ning mulohaza yuritishga tayangan tasvir yaratish va tahrirlash uchun Gemini 3 Pro Image modeli. Ishlab chiqaruvchi uning asosiy qo‘llanishlari markaziga murakkab grafik dizayn, asliga juda mos mahsulot maketlari va faktik ma’lumotlarni vizualizatsiya qilishni qo‘yadi. U matn va tasvirlarni qabul qiladi hamda tasvir va matn yaratadi. Ushbu nomlangan Pro tasvir nashri Gemini 3 Pro asosida yaratilgan bo‘lsa-da, tasvir vazifalari uchun o‘zining kirish va imkoniyatlar profilini saqlaydi.
Model 1K, 2K va 4K tasvirlarni qo‘llab-quvvatlaydi. Hujjatlashtirilgan shakllarga 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 va 21:9 kiradi. Kvadrat 4K tasvir 4096 × 4096; 16:9 nisbatdagi 4K tasvir esa 5504 × 3072. Portret poster, mahsulot sahnasi yoki keng tushuntiruvchi grafika bo‘lishidan qat’i nazar, aniqlik va tomonlar nisbatini kerakli materialga mos tanlang. Gemini 3.1 Flash Image’ning 0.5K varianti va qo‘shimcha keskin nisbatlari ushbu Pro jadvaliga kirmaydi.
Matnni tasvirga tushirish posterlar, diagrammalar va boshqa dizayn materiallarida aniq yozuvlarni qo‘llab-quvvatlaydi. Murakkab infografika uchun asosiy faktlar, aniq matn, o‘qish ketma-ketligi va yozuvlar bilan vizual elementlar o‘rtasidagi munosabatni bering. Yetkaziladigan ma’lumotni kerakli badiiy uslubdan ajrating. Google avval matnni tayyorlashni, keyin uni o‘z ichiga olgan tasvirni yaratishni tavsiya qiladi. Bu kompozitsiyada sarlavha, diagramma va bir nechta qisqa izoh birlashganda ayniqsa foydali.
Bir nechta tasvir kirishi 14 tagacha namunani qo‘llab-quvvatlaydi. Google imkoniyatlar jadvalida moslik uchun oltitagacha obyekt namunasi, izchillik uchun beshtagacha qahramon namunasi va uchtagacha uslub namunasi tavsiflangan. Bu vazifalar tarkibiy vizualni tayyorlashga yordam beradi: mahsulot fotosurati tashqi ko‘rinishni belgilaydi, alohida rasm muhitni beradi, uslub tasviri esa ishlov yo‘nalishini ko‘rsatadi. Har bir ko‘rinadigan xususiyatni farqlamasdan birlashtirishni so‘rash o‘rniga, qaysi tafsilotlar asosiy ishonchli manba va qaysi namunalar ilhom manbai ekanini modelga ayting.
Google Search orqali manbalarga asoslash faktik vizualizatsiya yoki dolzarb sharoitlarga tayangan sahna uchun haqiqiy dunyo ma’lumotlarini berishi mumkin. Pro tasvir ish jarayonida veb manbalariga asoslash hujjatlashtirilgan; Image Search kengaytmasi esa aynan Nano Banana 2.1 va Gemini 3.1 Flash Image uchun hujjatlashtirilgan. Ma’lumot grafikasida ko‘rsatmoqchi bo‘lgan qiymatlarni bering yoki ishlab chiqaruvchi ish jarayonida manbalarga asoslangan ma’lumotni so‘rang, so‘ng munosabat, yozuvlar va joylashuvni aniq qiling. Qidiruvga tayangan generatsiya baribir tekshiriladigan tasvir yaratadi va tasvirlangan faktlarni tekshirish o‘rnini bosmaydi.
Mulohaza yuritish yakuniy tasvirlashdan oldin murakkab prompt kompozitsiyasini tuzishga yordam beradi. Tasvir qo‘llanmasida kompozitsiya va mantiqni sinash uchun ishlatiladigan, yakuniy materialdan farqli oraliq tasvirlar tavsiflangan. Nano Banana 2’ning minimal/high boshqaruv jadvalini yoki Nano Banana 2.1’ning standart darajasi medium bo‘lgan jadvalini ushbu Pro nashriga ko‘chirmang. Talabchan dizayn uchun vizual iyerarxiya, obyektlar o‘rtasidagi zarur munosabatlar va keyingi tahrirlarda saqlanishi shart bo‘lgan elementlardan iborat to‘liq topshiriq bering.
Model kartasida hali mavjud bo‘lgan muhim cheklovlar tasvirlangan: juda mayda matn va uzun parchalar yomon chiqishi, qahramon tashqi ko‘rinishi namunadan natijagacha o‘zgarishi, niqobli yoki qoralama chizmalarga asoslangan tahrirlar esa ko‘rsatmaga faqat qisman rioya qilishi yoki iz qoldirishi mumkin. U chap va o‘ngni ham chalkashtirishi yoki manba elementini yangi kompozitsiyaga ko‘chirishi mumkin. Mahsulotni tahrirlashda saqlanadigan geometriya va yozuvlarni aniq ayting hamda tahrirlangan hududni tekshiring; diagrammada esa strelkalar yo‘nalishi va obyektlarning bir-biriga nisbatan joylashuvini solishtiring.
Amaldagi API jadvalida kirish chegarasi 65,536 token, chiqish chegarasi 32,768 token deb ko‘rsatilgan. Tasvir yaratish, fikrlash, qidiruv manbalari bilan asoslash va paketli ishlov qo‘llab-quvvatlanadi; audio yaratish, funksiya chaqirish, kod bajarish, keshlash, tuzilgan chiqishlar, fayl qidirish, URL konteksti va Live API qo‘llab-quvvatlanmaydi. Ushbu profildagi tasvir vazifasi audio ham, video kirishini ham qabul qilmaydi. Yaratilgan tasvirlarda SynthID bor, so‘ralgan chiqish tasvirlari soniga esa har doim aynan rioya qilinmaydi.
Amaliy mahsulot topshirig‘i mahsulot tasviri, yoritish namunasi va aniq sarlavhani birlashtirishi mumkin: “Mahsulot nisbatlari va yozuvlarini saqlang, uni yumshoq yon yorug‘lik ostidagi och rangli tosh sirtida ko‘rsating va yuqori uchdan bir qismini berilgan sarlavha uchun bo‘sh qoldiring.” Faktik diagramma uchun har bir obyekt va bog‘lanishni belgilang hamda tasdiqlangan yozuvlarni bering. Suhbatda bitta o‘zgarish va saqlanadigan xususiyatlarni aytib natijani takomillashtiring, tanlangan tasvir va uning izohlovchi matnini dizayn materiali sifatida birga saqlang.
POST /v1/messagestextjson, sse| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar google/gemini-3-pro-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.004 / 1K token Chiqish · Chiqish tokenlari $0.024 / 1K token Kirish · Keshdan o‘qish $0.0004 / 1K token Kirish · Keshga yozish $0.00075 / 1K token Kirish · Keshga yozish, 1 soat — / 1K token Chiqish · Chiqish rasmi tokenlari $0.24 / 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.004 / 1K token Chiqish · Chiqish tokenlari $0.024 / 1K token Kirish · Keshdan o‘qish $0.0004 / 1K token Kirish · Keshga yozish $0.00075 / 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-3-pro-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-3-pro-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-3-pro-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 gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro
Ailoot Ultra google/gemini-3-pro-image
/v1/images
google/gemini-3-pro-image, gemini-3-pro-image-preview, nano-banana-pro, gemini-3-pro-image
Ingliz tilidagi texnik misol
Visualize a supplied packaging cycle\n\nCreate one landscape explanatory graphic showing this packaging return cycle: customer returns an empty jar, store inspects it, accepted jars are washed, clean jars are refilled. Use four large illustrated stages connected clockwise. Add only these exact labels: 'RETURN', 'INSPECT', 'WASH', 'REFILL'. Make the arrow direction and stage order unmistakable.One landscape image with four labeled stages and arrows matching the supplied cycle.Inspect that arrows connect RETURN to INSPECT to WASH to REFILL in that order, with exact labels.