Nano Banana 2 API-ді қалай пайдалану

CometAPI
AnnaFeb 27, 2026
Nano Banana 2 API-ді қалай пайдалану

Nano Banana 2 — қауымдастық Google-дің Gemini отбасындағы ең жаңа кескін генерациялау моделіне қолданатын қысқаша атау — жылдам, жоғары дәлдікті кескін генерациялау және өңдеу жөніндегі күтулерді жылдам қайта қалыптастырды. 2026 жылғы ақпанның соңында іске қосылған бұл “Flash Image” нұсқасы (Gemini 3.1 Flash Image / Nano Banana 2) жоғары өткізу қабілеті мен төмен кідіріс қажет ететін, кәсіби деңгейдегі нәтижелерге ұмтылатын әзірлеушілер мен өнім командаларын нысанаға алады. Бұл мақалада соңғы есептер мен құжаттаманы біріктіріп, Nano Banana 2 деген не, бенчмарк нәтижелеріндегі көрсеткіштері, оған қалай қол жеткізіп, қалай шақыруға болатыны (CometAPI сияқты үшінші тарап шлюздері арқылы қоса алғанда), сондай-ақ өндірісте қолдануға болатын практикалық промпт пен пайдалану үлгілері түсіндіріледі.

CometAPI көптеген модельдерді (кескін модельдерін қоса) біртекті эндпоинттер арқылы ұсынып, бірыңғай HTTP-стиль интерфейсін береді. Бұл вендорлар арасында ауысуды немесе бірнеше модель нәтижелерін біріктіруді жеңілдетеді. Nano Banana 2 (Gemini 3.1 Image) CometAPI-де қолжетімді.

Nano Banana 2 деген не?

Nano Banana 2 (ішкі деңгейде Gemini 3.1 Flash Image-пен үйлестірілген) — жылдамдықты, бір кескінге төмен құнды және шығармашылық пен редакциялық тапсырмаларға арналған нұсқауларды мұқият орындауды басым қылатын Google-дің шоғырланған, жоғары тиімді кескін генерациялау моделі. Ол жоғары сапалы “Pro” нұсқаларымен қатар жұмыс істеуге арналған: жоғары өткізу қабілеті үшін Nano Banana 2, ал премиум, актив деңгейіндегі нәтижелер үшін Nano Banana Pro (Gemini 3 Pro Image).

Ол келесілерді қамтамасыз етуге арналған:

  • Жылдам инференс (өте төмен кідіріске бағытталған, сондықтан генерация және өңдеу дерлік лезде сезіледі).
  • Жоғары визуал сапа, “Pro” отбасына жақындайды, бірақ есептеу/құны төмен.
  • Нұсқауларды жақсырақ орындау (сұралған субъектілерді, кескіндегі мәтінді және көп кейіпкерлі көріністерді дәлірек бейнелеу).
  • Кең рұқсат етілген рұқсаттар мен пішімдер, тез шағын алдын-ала қараудан бастап соңғы активтерге арналған 2K/4K тізбектеріне дейін.

Nano Banana 2 бастапқы Nano Banana / Pro-дан несімен ерекшеленеді?

  • Архитектура / қозғалтқыш: Gemini-дің Flash инференс стегіне (Gemini 3.1 Flash Image) негізделген, сондықтан ол ең жоғары сапа параметрлерінің бір бөлігін жылдамдық пен құнды айтарлықтай жақсарту үшін алмастырады.
  • Қолдану сценарийлері: Ауқымды автоматтандыруға (маркетинг активтері, миниатюралар, UI), дерлік нақты уақытта өңдеуге және кідіріс пен құн маңызды, бірақ субъект дәлдігі Pro деңгейінде қажет болатын жұмыс ағындарына өте қолайлы.

Nano Banana 2-нің бенчмарк өнімділігі

Nano Banana 2 API-ді қалай пайдалану

Санаттар бойынша тұрақтылық

Gemini 3.1 Flash Image Gemini 2.5 Flash-пен салыстырғанда хабарланған әр санатта өлшенетін жақсартуды көрсетеді.

Ең күшті өсімдер

  • Визуал сапа
  • Көп енгізуді композициялық өңдеу
  • Жалпы өңдеу орнықтылығы

Бәсекелік позициялау

  • Ішкі GenAI-Bench жалпы артықшылық рейтингінде көшбасшы.
  • Жалпы және визуал метрикаларда GPT-Image 1.5-тен озады.
  • Тар, біртіндеп жақсартулар түбегейлі өзгерістен гөрі архитектуралық жетілдіруді білдіреді.

Nano Banana 2-ге қалай қол жеткіземін?

Қайда қолжетімді

Nano Banana 2 Google-дің Gemini құралдары (Gemini қолданбасы), Gemini API (Google-дің AI әзірлеуші құжаттарында сипатталған) арқылы қолжетімді және Vertex AI сияқты бұлтты кәсіптік өнімдер арқылы алдын-ала қарау/кәсіптік интеграциялар үшін ұсынылуда. CometAPI сондай-ақ интеграцияны жеңілдететін қолдауды және орағыштарды жариялады.

Nano Banana 2 API (cometapi) қалай пайдалану керек: қандай опциялар бар?

CometAPI нұсқаулығы Gemini-стильді generateContent пішімін қолданады және кескіндерді Base64 ретінде candidates[0].content.parts[].inline_data.data өрісінде қайтарады. Файлды клиент жағында сақтау үшін осы Base64-ті декодтау қажет. Тек https: //generativelanguage.googleapis.com адресін https://api.cometapi.com адресіне ауыстыру жеткілікті. Қайтарылған кескін әдетте Base64-пен кодталған inline_data ретінде ұсынылады. Оны клиент жағында декодтап, файл ретінде сақтау керек. CometAPI жеңілдіктер ұсынып, Nano Banana 2 API-ін пайдалануға көмектеседі.

CometAPI Gemini модельдері үшін бірыңғай REST-орағыш пен нақты эндпоинттер береді — егер сіз бір ғана тіркелгі дерегін қолдануды және провайдерлерді қосымшаның кодын өзгертпей ауыстыруды қаласаңыз, бұл ыңғайлы. Nano Banana 2 үшін CometAPI бетінде олардың gemini-3.1-flash-image-preview:generateContent эндпоинтіне арналған тікелей curl үзіндісі бар. Төменде CometAPI құжаттамасына негізделген ретке келтірілген curl үлгісі берілген.

CometAPI арқылы Nano Banana 2-ні пайдалану алдындағы талаптар

CometAPI тіркелгісі және API кілті: CometAPI-де тіркелгі жасаңыз және API қатынау кілтін (sk-…) алыңыз. Бұл кілт CometAPI эндпоинттеріне барлық API сұрауларын аутентификациялау үшін пайдаланылады.

Бағдарламалау тілдері мен рантаймдар:

  • Node.js 18+ (JavaScript/TypeScript үшін)
  • Python 3.10+
  • (Немесе HTTP сұрауларын жібере алатын кез келген тіл)

HTTP құралдары немесе SDK-лар:

  • JavaScript үшін: fetch, axios немесе OpenAI-мен үйлесімді клиент
  • Python үшін: requests, httpx немесе OpenAI клиенті
  • Бұл құралдар API шақыруларын жіберуге және жауаптарды өңдеуге көмектеседі.

Сұрау үлгісіне қысқаша шолу

  • Негізгі URL: https://api.cometapi.com (CometAPI базасы).
  • Модель атаулары: gemini-3.1-flash-image-preview (Nano Banana 2 / gemini 3.1 Flash Image) немесе қолжетімділікке байланысты gemini-2.5-flash-image.
  • Аутентификация: Authorization: sk-xxxx тақырыбы — CometAPI әдетте sk- стильді кілтті қолданады.
  • Жауап: кескіндер Base64 ретінде response.candidates[0].content.parts[].inline_data.data астында қайтарылады. Декодтап, дискіге жазыңыз.

Үлгілік жұмыс ағыны (жоғары деңгей)

  1. API кілтін алыңыз CometAPI-ден.
  2. Модель идентификаторын таңдаңыз (мысалы, қолжетімділікке қарай gemini-3.1-flash-image немесе соған ұқсас).
  3. Промптыңызбен модельдің генерация эндпоинтіне POST сұрауын жіберіңіз.
  4. Қолданбаңызда қайтарылған кескін деректерін өңдеңіз (base64 декодтау, PNG ретінде ұсыну және т.б.).
  5. Кескінді өңдеу үшін сұрауға бастапқы кескін деректерін және өңдеу нұсқауларын қосыңыз.

Ресми Gemini API-ін пайдалану (text → image)

Төменде gemini-3.1-flash-image-preview үшін Gemini generateContent эндпоинтін шақыруды көрсететін қысқа Node.js үлгісі берілген (құжаттамадағы ресми үзінділерге ұқсас). YOUR_API_KEY мәнін тіркелгі дерегіңізбен ауыстырыңыз және өндірістік ортада қате өңдеуді қосыңыз.

# Get your CometAPI key from https://api.cometapi.com/console/token
# Export it as: export COMETAPI_KEY="your-key-here"

mkdir -p ./output

curl -s "https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "A woman leaning on a wooden railing of a traditional Chinese building. She is wearing a blue cheongsam with pink and red floral motifs and a headdress made of colorful flowers, including roses and lilacs. Realistic painting style, focusing on the textural details of the clothing patterns and wooden buildings."
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "9:16"
      }
    }
  }' | python3 -c "
import sys, json, base64
data = json.load(sys.stdin)
parts = data['candidates'][0]['content']['parts']
for part in parts:
    if 'text' in part:
        print(part['text'])
    elif 'inlineData' in part:
        img = base64.b64decode(part['inlineData']['data'])
        with open('./output/gemini-3.1-flash-image-preview.png', 'wb') as f:
            f.write(img)
        print('Image saved to ./output/gemini-3.1-flash-image-preview.png')
"

CometAPI SDK-лар мен OpenAI-мен үйлесімді клиент-орағыштарды ұсынады, сондықтан кейбір командалар провайдерді ең аз код өзгерістерімен ауыстыра алады; конфигурацияңызға қарай Base64-пен кодталған кескін шығыстарын немесе хостталған URL-дерді сұрата аласыз. Нақты жүктеме өрістері үшін әрқашан ресми generateContent схемасын тексеріңіз.

Кескін→Кескін (өңдеу) ағыны

Болған кескінді өңдеу үшін:

  1. Бастапқы кескінді Base64-ке түрлендіріңіз (data:image/...;base64, префиксінсіз).
  2. inline_data.data ішінде осы Base64 жолы және өңдеу промпты (мысалы, “артқы фонды ымырт аспанына ауыстыр, сутаңбаны алып таста”) бар жүктемемен POST жіберіңіз.
  3. Жауап ішінде декодтап, сақтайтын жаңа Base64 шығыс болады.
curl 
--location 
--request POST 'https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent' \ 
--header 'Authorization: ' \ 
--header 'Content-Type: application/json' \ 
--data-raw '{ "contents": 
[ { "role": "user", "parts": 
[ { "text": "Blend three images to output a high-resolution image" }, { "inline_data": { "mime_type": "image/jpeg", "data": "<your_first_image_base64_data_here>" } }, { "inline_data": { "mime_type": "image/jpeg", "data": "<your_second_image_base64_data_here>" } }, { "inline_data": { "mime_type": "image/jpeg", "data": "<your_third_image_base64_data_here>" } } 
] } 
], "generationConfig": { "responseModalities": [ "TEXT", "IMAGE" 
] } }'

Әдетте реттелетін параметрлер

  • model: gemini-3.1-flash-image-preview (Nano Banana 2) немесе gemini-3-pro-image-preview (Pro) таңдаңыз.
  • imageConfig.aspect_ratio және imageConfig.image_size (512, 1K, 2K, 4K) — құн мен кідіріске әсер етеді.
  • responseModalities: мультимодаль ағындар үшін ["Image"] немесе ["Text","Image"].

Nano Banana 2 үшін промптты қалай құрастыру керек?

Кескін модельдері үшін промпт инженериясы композиция, стилистика, камера/жарық кеңестері және шектеу мәлімдемелерін біріктіреді. Nano Banana 2 нұсқауларды сенімді орындауға бапталған, сондықтан қысқалық пен айқындықтың теңгерімін ұстаныңыз.

Ұсынылатын промпт құрылымы

  1. Басты субъект: кескінде кім/неге назар аударылады.
  2. Әрекет немесе күйі: субъект не істеп тұр.
  3. Орта және көңіл-күй: орнатылым, жарық, атмосфера.
  4. Техникалық нұсқаулар: камера линзасы, арақатынас, рұқсат, композиция.
  5. Стиль және анықтамалар: өнер стилі, суретшіге сілтемелер (авторлық құқық ережелерін ескеріңіз), дәуір.
  6. Шектеулер: кейіпкерлер/объектілер саны, кей түстерден қашу, оқылатын мәтінді қосу.

Үлгі промпт:

“Классикалық зымыран пішініндегі кішкентай сары бананның фото-реалистік кескіні, күн сәулесі түсіп тұрған студиядағы жылтыр махогани үстелдің үстінде тұр. 50мм линза, таяз фокустық тереңдік, жылы алтын сағат жарығы, жоғары деталь, көрінетін логотиптер жоқ, 2048×1152.”

Өңдеу промпттары үшін кеңестер (inpainting / ауыстыру)

  • Масканы анық беріп, қай аймақтар өзгеруі керегін нақтылаңыз.
  • Қалдыру қажет аймақтарға “сақта” деген сөздерді қолданыңыз (мысалы, “субъектінің бет ерекшеліктерін сақта, тек артқы фонды ауыстыр”).
  • Кескіндегі мәтін үшін нақтылы мәтінді беріп, қаріп/стильді айтыңыз (мысалы, “оқылатын sans-serif, ортасына тураланған”). Nano Banana 2 мәтінді жақсырақ рендерлеуді басым етеді, бірақ нақтылау маңызды.

Промптты дебагтау чек-листі

  • Нәтиже дәл келмесе: алдымен шығармашылық стиль нұсқауларын азайтып көріңіз, кейін егжей-тегжей қосыңыз.
  • Мәтін оқылмаса: промптта қаріпті, өлшемін және контрастын нақтылап, рұқсатты арттырыңыз.
  • Композиция қате болса: камера бұрышы мен линза спецификаторларын пайдаланыңыз.

Жиі кездесетін қателер және олардан қалай қашу керек?

Қате: Бір ғана промптқа шамадан тыс сену

Қырқу, орналасу және көпқадамды өңдеуді бір промптпен толық шешуді күтуден қашыңыз. Жұмысты бөліңіз: базаны генерациялау → өңдеу/ауыстыру → финалдық жылтырату. Дәлдік үшін seed пен маскаларды қолданыңыз.

Қате: Шығу тегі мен авторлық құқық тексерулерін елемеу

SynthID/C2PA немесе өзге provenance тетіктерінсіз ауқымды түрде жариялауға болмайды. Көптеген кәсіпорындар AI-мен жасалған контент үшін қадағалануын талап етеді.

Қате: Бюджетке тосынсыйлар

Қолдануды модель және эндпоинт деңгейінде қадағалаңыз, провайдер немесе прокси арқылы қатаң лимиттер орнатыңыз. Flash деңгейлері арзандау, бірақ кездейсоқ мыңдаған 4K кескіндер рендерленсе, шығын көп болуы мүмкін.

Nano Banana 2-пен ұсынылатын үздік тәжірибелер?

Кескін генерациясын өндірісте қолдану құн, кідіріс, сапаны бақылау, provenance және қауіпсіздікке мұқият қарауды қажет етеді. Төменде дала есептерінен, Google құжаттарынан және қауымдастық тесттерінен жинақталған практикалық үздік тәжірибелер берілген.

Промпт инженериясы және детерминирленген нәтижелер

  • Промпттарыңызды үлгілеңіз: қайталанатын нәтижелер (мысалы, өнім фотолары) үшін субъект, камера, жарық, текстура, пост-өңдеу сияқты бекітілген сегменттері бар құрылымдалған промпттарды қолданыңыз. Бұл шақырулар арасындағы дрейфті азайтады.
  • Өңдеулер үшін анықтамалық кескіндер мен маска нұсқауларын пайдаланыңыз, күрделі локальды өңдеулерді тек мәтінмен жасауға тырысқаннан гөрі — бұл семантикалық қателер мен артефактілерді азайтады.

Құн және өнімділікті баптау

  • Көп көлем үшін Flash/“Nano Banana 2” режимін таңдаңыз: егер тез итерациялар көп қажет болса, Flash деңгейлі модельдерді және кіші рұқсаттарды (2K vs 4K) қолданып, құн мен кідірісті азайтыңыз.
  • Сұрауларды пакеттеңіз, мүмкін болса: кей провайдерлер мульти-промпт пакеттеуді қолдайды — бұл жоғары өткізу ағындарында бір активке жалпы кідірісті азайтады. (Провайдер құжатын тексеріңіз.)

Қауіпсіздік, provenance және құқықтық талаптар

  • SynthID және C2PA метадеректерін генерацияланған активтерде қосыңыз — төменгі деңгейдегі аудит пен сәйкестікке қолдау көрсету үшін (әсіресе кескіндер жарнама/PR-де қолданылса). Google және серіктестері provenance механизмі ретінде SynthID-ті атап өтеді.
  • Сезімтал контент үшін адамның қатысуымен шолу: автоматтандырылған саясат қабаттары мықты, бірақ мінсіз емес — көпшілікке бағытталған кампаниялар немесе танымал тұлғалар қатысқан контент үшін қолмен тексеруді пайдаланыңыз.

Сапаны қамтамасыз ету

  • QA тексерулерін автоматтандырыңыз: генерациядан кейін күтпеген артефактілерді анықтау үшін жылдам классификатор жүргізіңіз (мәтіннің дұрыс рендерленбеуі, бет дәлдігінің төмендігі, кездейсоқ логотиптердің пайда болуы). Бағалау жүйесін сақтап, авто-тексеру сәтсіз болса, Pro деңгейлі рендерлерге қауіпсіз қайту құралы болсын.
  • Промпттар мен seed-терді сақтаңыз: аудит пен қайталанғыштық үшін дәл промптты, уақыт белгілерін, модель нұсқасын және қолданылған кез келген seed немесе детерминирленген параметрді сақтаңыз.

Кідіріс сезімтал UX

  • Прогрессивті UX: алдымен төмен рұқсатты/жылдам драфтты қайтарып, дайын болғанда жоғары рұқсатты/Pro рендерді ауыстырыңыз. Бұл қолданбаңыздың жауап беруін сақтайды (көп провайдерлер “draft” немесе Flash түрін ұсынады).

Қорытынды ескертпелер және келесі қадамдар

Nano Banana 2 кескін-алғаш жұмыс ағындарының экономикасын өзгерту үшін салынған: төмен кідіріс пен бір шақыруға төмен құн талапқа сай, жедел тапсырыс бойынша жарнама активтерін генерациялау, тез A/B шығармашылық тесттері және нақты уақыттағы бірлескен дизайн құралдары сияқты қолдануларды ашады. Модель Google-дің тұтынушылық және бұлттық беттерінде әлдеқашан интеграцияланған; тез іске қосылғысы келетін әзірлеушілер үшін CometAPI Gemini кескін эндпоинттерін және басқа модельдерді қолдайтын ыңғайлы маркетплейс-орағыш береді — қосымша кодын өзгертпей бірнеше қозғалтқышпен тәжірибе жасау керек болғанда бұл практикалық шешім.
Әзірлеушілер Nano Banana 2 моделіне қазір CometAPI арқылы қол жеткізе алады. Бастау үшін Playground ішіндегі модель мүмкіндіктерін зерттеп, егжей-тегжейлі нұсқаулар үшін API guide құжатын қараңыз. Қол жеткізбестен бұрын CometAPI жүйесіне кіріп, API кілтін алғаныңызға көз жеткізіңіз. CometAPI интеграциялау үшін ресми бағадан әлдеқайда төмен баға ұсынады.

Дайынсыз ба?→ Бүгін Nano Banana 2 үшін тіркеліңіз !

Егер AI туралы көбірек кеңестерді, нұсқаулықтарды және жаңалықтарды білгіңіз келсе, бізді VK, X және Discord желілерінде қадағалаңыз!

Жоғары деңгейдегі модельдерге төмен бағамен қол жеткізіңіз

Толығырақ оқу