{"id":4963,"date":"2025-11-21T03:47:46","date_gmt":"2025-11-21T07:47:46","guid":{"rendered":"https:\/\/wp.glbgpt.com\/?p=4963"},"modified":"2026-07-23T04:06:57","modified_gmt":"2026-07-23T08:06:57","slug":"how-to-use-nano-banana-pro-api","status":"publish","type":"post","link":"https:\/\/wp.glbgpt.com\/pt-br\/hub\/how-to-use-nano-banana-pro-api","title":{"rendered":"Como usar a API do Nano Banana Pro\/Nano Banana 2 \u2014 Guia passo a passo para desenvolvedores"},"content":{"rendered":"<p class=\"wp-block-paragraph\">Se voc\u00ea pesquisou por \u201cNano Banana Pro API\u201d, a primeira coisa que pode causar confus\u00e3o \u00e9 o nome. O nome do produto \u00e9 Nano Banana Pro. O nome da API que voc\u00ea realmente usa no c\u00f3digo \u00e9 <code>gemini-3-pro-image<\/code>. Uma vez esclarecido isso, o restante da configura\u00e7\u00e3o fica bem menos complicado.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Use o Nano Banana Pro quando for necess\u00e1rio manter a coes\u00e3o da imagem: texto leg\u00edvel, detalhes do produto, refer\u00eancias \u00e0 marca, layouts localizados ou um briefing visual com muitas restri\u00e7\u00f5es espec\u00edficas. Se voc\u00ea ainda estiver testando dez vers\u00f5es da mesma ideia, comece primeiro com o Nano Banana 2 e passe para o Pro quando valer a pena investir mais nessa dire\u00e7\u00e3o.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Se sua equipe ainda est\u00e1 elaborando prompts em vez de lan\u00e7ar um aplicativo, <a href=\"https:\/\/www.glbgpt.com\/home\/nano-banana?inviter=hub_content_nano&amp;login=1\" data-wpel-link=\"exclude\">Espa\u00e7o de trabalho Nano Banana Pro da GlobalGPT<\/a> \u00e9 um recurso pr\u00e1tico para comparar resultados antes que um desenvolvedor configure a API oficial. Trata-se de um atalho criativo no fluxo de trabalho, e n\u00e3o um substituto para o console de API do Google, o faturamento, os registros ou os controles corporativos.<\/p>\n\n\n\n<nav class=\"nbp-toc\" aria-label=\"\u00cdndice\">\n  <strong>O que ler primeiro<\/strong>\n  <ol>\n    <li><a href=\"#quick-answer\">Resposta r\u00e1pida<\/a><\/li>\n    <li><a href=\"#what-is-api\">O que \u00e9, na verdade, a API Nano Banana Pro<\/a><\/li>\n    <li><a href=\"#model-choice\">Nano Banana Pro x Nano Banana 2<\/a><\/li>\n    <li><a href=\"#setup\">Configurar a API com os pontos de entrada reais<\/a><\/li>\n    <li><a href=\"#generate-image\">Gerar uma primeira imagem<\/a><\/li>\n    <li><a href=\"#edit-images\">Editar imagens com refer\u00eancias<\/a><\/li>\n    <li><a href=\"#costs\">Pre\u00e7os e controle de custos<\/a><\/li>\n    <li><a href=\"#production\">Notas de produ\u00e7\u00e3o<\/a><\/li>\n    <li><a href=\"#globalgpt\">Onde o GlobalGPT se encaixa<\/a><\/li>\n    <li><a href=\"#faq\">PERGUNTAS FREQUENTES<\/a><\/li>\n  <\/ol>\n<\/nav>\n\n\n\n<h2 id=\"quick-answer\" class=\"wp-block-heading\">Resposta r\u00e1pida<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Para usar o Nano Banana Pro por meio de uma API, crie um projeto no Google AI Studio ou no Google Cloud, gere uma chave de API do Gemini, instale o SDK do Google Gen AI e chame <code>gemini-3-pro-image<\/code>. Comece com uma solicita\u00e7\u00e3o simples de convers\u00e3o de texto em imagem. Se voc\u00ea ainda estiver verificando o acesso antes de criar uma API, o <a href=\"https:\/\/www.glbgpt.com\/hub\/how-to-get-the-gemini-3-pro-free-trial-step-by-step-guide\/\">Guia passo a passo da vers\u00e3o de avalia\u00e7\u00e3o gratuita do Gemini 3 Pro<\/a> \u00e9 uma leitura complementar \u00fatil.<\/p>\n\n\n\n<div class=\"wp-block-group has-custom-css is-layout-constrained wp-block-group-is-layout-constrained wp-custom-css-00401371\">\n<p class=\"wp-block-paragraph\"><strong>A vers\u00e3o resumida<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>ID do modelo da API para o Nano Banana Pro:\u00a0<code>gemini-3-pro-image<\/code>.<\/li>\n\n\n\n<li>Utilize o Nano Banana Pro para ativos finais, textos complexos, restri\u00e7\u00f5es de marca e refer\u00eancias detalhadas.<\/li>\n\n\n\n<li>Utilize o Nano Banana 2, conforme documentado como\u00a0<code>gemini-3.1-flash-image<\/code>, para ciclos de rascunho mais r\u00e1pidos.<\/li>\n\n\n\n<li>Se voc\u00ea ainda n\u00e3o estiver desenvolvendo um aplicativo, teste o fluxo de trabalho do prompt no GlobalGPT antes de mexer nas chaves de API.<\/li>\n<\/ul>\n<\/div>\n\n\n\n<h2 id=\"what-is-api\" class=\"wp-block-heading\">O que \u00e9, na verdade, a API Nano Banana Pro<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O Nano Banana Pro \u00e9 o modelo premium de gera\u00e7\u00e3o de imagens nativas do Google na fam\u00edlia de imagens Gemini. Na documenta\u00e7\u00e3o para desenvolvedores, o Google o denomina <strong>Imagem do Gemini 3 Pro<\/strong>. \u00c9 por isso que a string do modelo parece diferente do nome de marketing.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A API pode gerar uma imagem a partir de texto, utilizar uma ou mais imagens de refer\u00eancia e editar uma imagem existente de acordo com instru\u00e7\u00f5es escritas. Isso a torna \u00fatil para maquetes de produtos, variantes de an\u00fancios, diagramas, criativos localizados e fluxos de trabalho de imagens em que o texto dentro da imagem precisa permanecer leg\u00edvel; para explora\u00e7\u00e3o sem c\u00f3digo, a <a href=\"https:\/\/www.glbgpt.com\/image-generator?inviter=hub_content_image_api&amp;login=1\" data-wpel-link=\"exclude\">Gerador de imagens GlobalGPT<\/a> \u00e9 o lugar mais f\u00e1cil para testar a dire\u00e7\u00e3o criativa primeiro.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img fetchpriority=\"high\" decoding=\"async\" width=\"1024\" height=\"576\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/02-google-image-generation-models-en-1024x576.webp\" alt=\"Documenta\u00e7\u00e3o do Google sobre gera\u00e7\u00e3o de imagens com IA para o Nano Banana e o Nano Banana Pro\" class=\"wp-image-16993\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/02-google-image-generation-models-en-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/02-google-image-generation-models-en-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/02-google-image-generation-models-en-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/02-google-image-generation-models-en-18x10.webp 18w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/02-google-image-generation-models-en.webp 1265w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 id=\"model-choice\" class=\"wp-block-heading\">Nano Banana Pro x Nano Banana 2<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A escolha n\u00e3o tem tanto a ver com qual nome soa mais moderno, mas sim com o est\u00e1gio em que voc\u00ea se encontra no trabalho. \u201cPro\u201d \u00e9 para o passe preciso. \u201cNano Banana 2\u201d \u00e9 para o ciclo de rascunho desorganizado; se essa rota mais r\u00e1pida \u00e9 o que voc\u00ea precisa, leia o <a href=\"https:\/\/www.glbgpt.com\/hub\/nano-banana-2-free-trial\/\">Nano Banana: Guia para 2 testes gratuitos<\/a> antes de projetar todo o fluxo de trabalho com base no Pro.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Decis\u00e3o<\/strong><\/td><td><strong>Nano Banana Pro<\/strong><\/td><td><strong>Nano Banana 2<\/strong><\/td><\/tr><tr><td><strong>ID do modelo da API<\/strong><\/td><td>gemini-3-pro-image<\/td><td>gemini-3.1-flash-image<\/td><\/tr><tr><td><strong>Melhor emprego<\/strong><\/td><td>Recursos criativos finais, imagens com muito texto, consist\u00eancia da marca, edi\u00e7\u00f5es controladas<\/td><td>Rascunhos, explora\u00e7\u00e3o imediata, varia\u00e7\u00f5es r\u00e1pidas, tiragens de imagens a custo reduzido<\/td><\/tr><tr><td><strong>Estilo de prompt<\/strong><\/td><td>Restri\u00e7\u00f5es espec\u00edficas, imagens de refer\u00eancia, tamanho da sa\u00edda, regras de texto, notas de localiza\u00e7\u00e3o<\/td><td>Prompts mais curtos e testes com maior variedade<\/td><\/tr><tr><td><strong>H\u00e1bito de gastos<\/strong><\/td><td>Use depois que a ideia j\u00e1 estiver quase pronta<\/td><td>Aproveite enquanto a ideia ainda est\u00e1 fresca<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"576\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/03-google-model-list-section-en-1024x576.webp\" alt=\"Documenta\u00e7\u00e3o do Google que apresenta o Nano Banana Pro como Gemini 3 Pro Image, com o ID do modelo gemini-3-pro-image\" class=\"wp-image-16996\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/03-google-model-list-section-en-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/03-google-model-list-section-en-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/03-google-model-list-section-en-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/03-google-model-list-section-en-18x10.webp 18w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/03-google-model-list-section-en.webp 1265w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 id=\"setup\" class=\"wp-block-heading\">Configurar a API com os pontos de entrada reais<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Para um prot\u00f3tipo, o Google AI Studio costuma ser o caminho mais r\u00e1pido. Para um aplicativo corporativo, use a configura\u00e7\u00e3o do Google Cloud na qual sua equipe j\u00e1 confia, especialmente se voc\u00ea precisar de faturamento compartilhado, controle de acesso, registro de logs ou governan\u00e7a do Vertex AI. Se a decis\u00e3o sobre o acesso depender realmente dos n\u00edveis dos planos do Google, compare as vantagens e desvantagens na <a href=\"https:\/\/www.glbgpt.com\/hub\/google-ai-plus-vs-pro\/\">Guia comparativo entre o Google AI Plus e o Pro<\/a> antes de considerar a configura\u00e7\u00e3o da API como o \u00fanico problema.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">A documenta\u00e7\u00e3o p\u00fablica \u00e9 o melhor ponto de partida. Ela permite que voc\u00ea confirme se est\u00e1 na p\u00e1gina de gera\u00e7\u00e3o de imagens do Nano Banana, verifique se a p\u00e1gina est\u00e1 utilizando o caminho recomendado da API de Intera\u00e7\u00f5es e acesse, a partir da\u00ed, os pontos de entrada da chave de API ou do AI Studio.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"1024\" height=\"576\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/05-step-docs-open-image-generation-1024x576.webp\" alt=\"P\u00e1gina de documenta\u00e7\u00e3o da API do Google Gemini para gera\u00e7\u00e3o de imagens Nano Banana\" class=\"wp-image-16999\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/05-step-docs-open-image-generation-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/05-step-docs-open-image-generation-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/05-step-docs-open-image-generation-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/05-step-docs-open-image-generation-18x10.webp 18w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/05-step-docs-open-image-generation.webp 1265w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Crie ou abra um projeto do Google AI Studio ou do Google Cloud.<\/li>\n\n\n\n<li>Crie uma chave de API Gemini.<\/li>\n\n\n\n<li>Armazene a chave como uma vari\u00e1vel de ambiente do lado do servidor.<\/li>\n\n\n\n<li>Instale o SDK do Google Gen AI no seu projeto de back-end.<\/li>\n\n\n\n<li>Execute um teste em baixa resolu\u00e7\u00e3o antes de adicionar imagens de refer\u00eancia ou recursos voltados para o usu\u00e1rio.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">A p\u00e1gina da chave da API tamb\u00e9m \u00e9 p\u00fablica, mas a cria\u00e7\u00e3o ou visualiza\u00e7\u00e3o de uma chave depende da sua conta do Google e das permiss\u00f5es do projeto. O ponto principal: mantenha essa chave fora do JavaScript do front-end. Um navegador ou aplicativo m\u00f3vel deve fazer a chamada para o seu back-end, e o seu back-end deve fazer a chamada para o Gemini.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"576\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/07-step-api-key-docs-1024x576.webp\" alt=\"P\u00e1gina de documenta\u00e7\u00e3o da chave de API Gemini do Google com o bot\u00e3o \u201cCriar ou visualizar uma chave de API Gemini\u201d\" class=\"wp-image-17000\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/07-step-api-key-docs-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/07-step-api-key-docs-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/07-step-api-key-docs-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/07-step-api-key-docs-18x10.webp 18w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/07-step-api-key-docs.webp 1265w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Ap\u00f3s o login, a URL direta do AI Studio realmente leva ao Playground com <code>Nano Banana Pro<\/code> escolhido como <code>gemini-3-pro-image<\/code>. Nessa explica\u00e7\u00e3o, o AI Studio tamb\u00e9m destacou uma limita\u00e7\u00e3o pr\u00e1tica: o Nano Banana Pro requer um Plano de IA do Google ou uma chave de API para que o Playground possa execut\u00e1-lo.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"525\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/08-aistudio-model-selected-1024x525.webp\" alt=\"Google AI Studio Playground com o Nano Banana Pro selecionado como gemini-3-pro-image\" class=\"wp-image-17001\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/08-aistudio-model-selected-1024x525.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/08-aistudio-model-selected-300x154.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/08-aistudio-model-selected-768x394.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/08-aistudio-model-selected-1536x788.webp 1536w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/08-aistudio-model-selected-18x9.webp 18w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/08-aistudio-model-selected.webp 1707w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">O <strong>Obter c\u00f3digo<\/strong> Ainda vale a pena conferir o bot\u00e3o neste momento. Ele confirma que voc\u00ea est\u00e1 no fluxo de trabalho do desenvolvedor, mas, se o modelo estiver bloqueado para a conta, o painel de c\u00f3digo pode abrir sem um trecho de c\u00f3digo completo e execut\u00e1vel. Isso \u00e9 um sinal de configura\u00e7\u00e3o, n\u00e3o um bug do prompt.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"525\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/09-aistudio-get-code-1024x525.webp\" alt=\"O painel \u201cObter c\u00f3digo\u201d do Google AI Studio foi aberto a partir do Nano Banana Pro Playground\" class=\"wp-image-17002\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/09-aistudio-get-code-1024x525.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/09-aistudio-get-code-300x154.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/09-aistudio-get-code-768x394.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/09-aistudio-get-code-1536x788.webp 1536w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/09-aistudio-get-code-18x9.webp 18w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/09-aistudio-get-code.webp 1707w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<div style=\"margin:22px 0;border:1px solid #d8e0ea;border-radius:8px;overflow:hidden;background:#0f172a;box-shadow:0 10px 28px rgba(15,23,42,.08);\">\n  <div style=\"display:flex;justify-content:space-between;gap:12px;align-items:center;padding:10px 14px;background:#f8fafc;border-bottom:1px solid #d8e0ea;color:#0f172a;font:600 14px\/1.4 Arial,sans-serif;\">\n    <span>Terminal<\/span>\n    <span style=\"color:#64748b;font-size:13px;\">Vari\u00e1vel de ambiente<\/span>\n  <\/div>\n  <pre aria-label=\"Comando do terminal\" style=\"display:block!important;margin:0!important;padding:18px!important;overflow:auto!important;border:0!important;border-radius:0!important;background:#0f172a!important;color:#f8fafc!important;-webkit-text-fill-color:#f8fafc!important;font:14px\/1.65 Consolas,Monaco,'Courier New',monospace!important;white-space:pre!important;tab-size:2!important;box-shadow:none!important;\">export GEMINI_API_KEY=\"SUA_CHAVE_DE_API\"<\/pre>\n<\/div>\n\n\n\n<h2 id=\"generate-image\" class=\"wp-block-heading\">Gerar uma primeira imagem<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">A primeira solicita\u00e7\u00e3o deve ser deliberadamente simples. Voc\u00ea est\u00e1 verificando a autentica\u00e7\u00e3o, o acesso ao modelo, o formato da resposta e o tratamento de arquivos. Trabalhos mais complexos com prompts podem esperar at\u00e9 que tudo esteja funcionando corretamente.<\/p>\n\n\n\n<div style=\"margin:22px 0;border:1px solid #d8e0ea;border-radius:8px;overflow:hidden;background:#0f172a;box-shadow:0 10px 28px rgba(15,23,42,.08);\">\n  <div style=\"display:flex;justify-content:space-between;gap:12px;align-items:center;padding:10px 14px;background:#f8fafc;border-bottom:1px solid #d8e0ea;color:#0f172a;font:600 14px\/1.4 Arial,sans-serif;\">\n    <span>Python<\/span>\n    <span style=\"color:#64748b;font-size:13px;\">generate-image.py<\/span>\n  <\/div>\n  <pre aria-label=\"Exemplo em Python: generate-image.py\" style=\"display:block!important;margin:0!important;padding:18px!important;overflow:auto!important;border:0!important;border-radius:0!important;background:#0f172a!important;color:#f8fafc!important;-webkit-text-fill-color:#f8fafc!important;font:14px\/1.65 Consolas,Monaco,'Courier New',monospace!important;white-space:pre!important;tab-size:2!important;box-shadow:none!important;\">from google import genai\nfrom google.genai import types\nimport os\n\nclient = genai.Client(api_key=os.environ[\"GEMINI_API_KEY\"])\n\nresponse = client.models.generate_content(\n    model=\"gemini-3-pro-image\",\n    contents=(\n \"Crie uma maquete de produto bem organizada de uma caneca de viagem de a\u00e7o inoxid\u00e1vel\"\n \"sobre uma mesa branca. Adicione o r\u00f3tulo leg\u00edvel: MORNING LAB.\"\n    ),\n    config=types.GenerateContentConfig(\n response_modalities=[\"TEXT\", \"IMAGE\"]\n    ),\n)\n\nfor part in response.candidates[0].content.parts:\n    if part.text:\n print(part.text)\n    elif part.inline_data:\n with open(\"nano-banana-pro-output.png\", \"wb\") as f:\n f.write(part.inline_data.data)<\/pre>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Essa solicita\u00e7\u00e3o pede uma maquete simples de produto com texto leg\u00edvel. Isso d\u00e1 a voc\u00ea uma indica\u00e7\u00e3o r\u00e1pida sobre tr\u00eas aspectos importantes no trabalho real: realismo do objeto, composi\u00e7\u00e3o e se o modelo consegue manter um texto curto n\u00edtido. Para ajustar a solicita\u00e7\u00e3o sem alterar as credenciais, tente o mesmo briefing em <a href=\"https:\/\/www.glbgpt.com\/home\/nano-banana?inviter=hub_content_generate_test&amp;login=1\" data-wpel-link=\"exclude\">Espa\u00e7o de trabalho Nano Banana Pro da GlobalGPT<\/a> Primeiro.<\/p>\n\n\n\n<h2 id=\"edit-images\" class=\"wp-block-heading\">Editar imagens com refer\u00eancias<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\u00c9 na edi\u00e7\u00e3o baseada em refer\u00eancia que o Nano Banana Pro come\u00e7a a mostrar seu valor. Em vez de solicitar uma nova imagem do zero, voc\u00ea fornece uma imagem ao modelo e indica exatamente o que pode ser alterado e o que deve permanecer inalterado.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Se voc\u00ea n\u00e3o for um desenvolvedor, leia este bloco como um exemplo de fluxo de trabalho, e n\u00e3o como algo que voc\u00ea precise executar. O nome do arquivo <code>product-reference.png<\/code> significa simplesmente \u201ca imagem do seu produto atual\u201d. Se sua principal tarefa for comparar modelos de imagem, o conceito mais amplo <a href=\"https:\/\/www.glbgpt.com\/hub\/gemini-3-pro-alternative-we-tried-8-better-options\/\">Teste de alternativas ao Gemini 3 Pro<\/a> pode ajudar voc\u00ea a decidir se vale a pena fazer a configura\u00e7\u00e3o adicional do Pro.<\/p>\n\n\n\n<div style=\"margin:22px 0;border:1px solid #d8e0ea;border-radius:8px;overflow:hidden;background:#0f172a;box-shadow:0 10px 28px rgba(15,23,42,.08);\">\n  <div style=\"display:flex;justify-content:space-between;gap:12px;align-items:center;padding:10px 14px;background:#f8fafc;border-bottom:1px solid #d8e0ea;color:#0f172a;font:600 14px\/1.4 Arial,sans-serif;\">\n    <span>Python<\/span>\n    <span style=\"color:#64748b;font-size:13px;\">edit-with-reference.py<\/span>\n  <\/div>\n  <pre aria-label=\"Exemplo em Python: edit-with-reference.py\" style=\"display:block!important;margin:0!important;padding:18px!important;overflow:auto!important;border:0!important;border-radius:0!important;background:#0f172a!important;color:#f8fafc!important;-webkit-text-fill-color:#f8fafc!important;font:14px\/1.65 Consolas,Monaco,'Courier New',monospace!important;white-space:pre!important;tab-size:2!important;box-shadow:none!important;\">from google import genai\nfrom google.genai import types\nfrom PIL import Image\nimport os\n\nclient = genai.Client(api_key=os.environ[\"GEMINI_API_KEY\"])\nreference = Image.open(\"product-reference.png\")\n\nresponse = client.models.generate_content(\n    model=\"gemini-3-pro-image\",\n    contents=[\n reference,\n (\n \"Mantenha o formato da caneca, a al\u00e7a e o posicionamento do logotipo inalterados. \"\n            \"Altere o fundo para uma bancada de cozinha clara, adicione uma luz quente de manh\u00e3, \"\n \"e mantenha todo o texto n\u00edtido e leg\u00edvel.\"\n ),\n    ],\n    config=types.GenerateContentConfig(response_modalities=[\"TEXT\", \"IMAGE\"]),\n)<\/pre>\n<\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Uma boa orienta\u00e7\u00e3o de edi\u00e7\u00e3o soa quase como um feedback para um designer: mantenha isso, mude aquilo, n\u00e3o mova o logotipo, mantenha o texto leg\u00edvel. Instru\u00e7\u00f5es vagas, como \u201cd\u00ea um ar mais sofisticado\u201d, tendem a desperdi\u00e7ar tentativas, pois deixam muito espa\u00e7o para o modelo ter que adivinhar.<\/p>\n\n\n\n<h2 id=\"costs\" class=\"wp-block-heading\">Pre\u00e7os e controle de custos<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Use a p\u00e1gina de pre\u00e7os do Google como fonte oficial antes de publicar valores fixos de or\u00e7amento. Conforme verificado em 21 de julho de 2026, o Google lista o Nano Banana Pro na categoria Gemini 3 Pro Image e separa o custo de texto\/racioc\u00ednio do custo de gera\u00e7\u00e3o de imagens.<\/p>\n\n\n\n<p class=\"has-text-color wp-block-paragraph\" style=\"color:#111827;margin-top:22px;margin-bottom:12px;font-size:18px\"><strong>Custos de gera\u00e7\u00e3o de imagens pela API, verificados em 21 de julho de 2026<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Modelo<\/strong><\/td><td><strong>Exibi\u00e7\u00e3o de imagem paga<\/strong><\/td><td><strong>Equivalente listado no Google<\/strong><\/td><td><strong>Bom uso padr\u00e3o<\/strong><\/td><\/tr><tr><td><strong>Imagem do Gemini 3 Pro \/ Nano Banana Pro<\/strong><\/td><td>$120,00 por 1 milh\u00e3o de tokens de imagem<\/td><td>$0.134 por imagem de 1K\/2K; $0.24 por imagem de 4K<\/td><td>Recursos finais e trabalho com imagens de alta resolu\u00e7\u00e3o<\/td><\/tr><tr><td><strong>Imagem de flash do Gemini 3.1 \/ Nano Banana 2<\/strong><\/td><td>$30,00 por 1 milh\u00e3o de tokens de imagem<\/td><td>$0,0336 por imagem de 1K<\/td><td><br>Rascunhos, variantes e testes de prompts<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"576\" src=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/04-google-pricing-gemini-3-pro-image-en-2-1024x576.webp\" alt=\"Se\u00e7\u00e3o de pre\u00e7os do Google para o Gemini 3 Pro e o Nano Banana Pro\" class=\"wp-image-17003\" srcset=\"https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/04-google-pricing-gemini-3-pro-image-en-2-1024x576.webp 1024w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/04-google-pricing-gemini-3-pro-image-en-2-300x169.webp 300w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/04-google-pricing-gemini-3-pro-image-en-2-768x432.webp 768w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/04-google-pricing-gemini-3-pro-image-en-2-18x10.webp 18w, https:\/\/wp.glbgpt.com\/wp-content\/uploads\/2025\/11\/04-google-pricing-gemini-3-pro-image-en-2.webp 1265w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">O modelo de custos pr\u00e1tico \u00e9 simples: fa\u00e7a rascunhos mais baratos e finalize com cuidado. Deixe que o Nano Banana 2 lide com as varia\u00e7\u00f5es iniciais e, em seguida, envie os prompts e refer\u00eancias mais robustos para o Nano Banana Pro para as imagens finais. Al\u00e9m disso, limite a resolu\u00e7\u00e3o de acordo com o n\u00edvel do usu\u00e1rio e evite gera\u00e7\u00f5es repetidas quando o prompt n\u00e3o tiver mudado; se voc\u00ea quiser uma linha de rascunho voltada para o produto, <a href=\"https:\/\/www.glbgpt.com\/image-generator\/nano-banana-2?inviter=hub_content_cost_control&amp;login=1\" data-wpel-link=\"exclude\">Nano Banana 2 em GlobalGPT<\/a> \u00e9 a op\u00e7\u00e3o mais leve para testar primeiro.<\/p>\n\n\n\n<h2 id=\"production\" class=\"wp-block-heading\">Notas de produ\u00e7\u00e3o<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Quando os usu\u00e1rios puderem gerar imagens a partir do seu produto, voc\u00ea precisar\u00e1 estabelecer limites. As APIs de imagem podem se tornar caras rapidamente, e as falhas precisam ser explicadas sem expor detalhes brutos do provedor. As equipes que ainda est\u00e3o decidindo quem precisa de acesso pago \u00e0 IA tamb\u00e9m podem comparar fluxos de trabalho no modelo de assinatura no <a href=\"https:\/\/www.glbgpt.com\/hub\/chatgpt-business-plan\/\">ChatGPT Guia para elabora\u00e7\u00e3o de plano de neg\u00f3cios<\/a>.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Mantenha as chaves no lado do servidor:<\/strong> N\u00e3o envie a chave API Gemini em um navegador ou cliente m\u00f3vel.<\/li>\n\n\n\n<li><strong>Registre informa\u00e7\u00f5es suficientes para a depura\u00e7\u00e3o:<\/strong> ID do modelo, hash do prompt, tamanho da sa\u00edda, lat\u00eancia, ID do usu\u00e1rio e status do resultado.<\/li>\n\n\n\n<li><strong>Definir cotas:<\/strong> limitar o n\u00famero de imagens por usu\u00e1rio, \u00e1rea de trabalho e per\u00edodo de cobran\u00e7a.<\/li>\n\n\n\n<li><strong>Tente novamente com cuidado:<\/strong> Tente novamente em caso de falhas tempor\u00e1rias, mas n\u00e3o tente novamente em caso de erros de pol\u00edtica ou cota em um loop.<\/li>\n\n\n\n<li><strong>Defina as regras de armazenamento:<\/strong> Saiba por quanto tempo voc\u00ea mant\u00e9m as imagens geradas e as refer\u00eancias enviadas.<\/li>\n\n\n\n<li><strong>Gere mensagens de erro \u00fateis:<\/strong> informe ao usu\u00e1rio se o problema est\u00e1 relacionado ao acesso, ao formato do arquivo, \u00e0 cota ou \u00e0 pol\u00edtica de solicita\u00e7\u00f5es.<\/li>\n<\/ul>\n\n\n\n<h2 id=\"globalgpt\" class=\"wp-block-heading\">Onde o GlobalGPT se encaixa<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">O GlobalGPT se encaixa melhor antes ou ao lado da compila\u00e7\u00e3o da API. Um designer pode comparar o Nano Banana Pro com <a href=\"https:\/\/www.glbgpt.com\/image-generator\/nano-banana-2?inviter=hub_content_nano2&amp;login=1\" data-wpel-link=\"exclude\">Nano Banana 2<\/a>, GPT Image, Flux e outros modelos de imagem em um \u00fanico espa\u00e7o de trabalho e, em seguida, repassar o padr\u00e3o de prompt vencedor ao desenvolvedor.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para chaves de API oficiais, faturamento, registros, acesso corporativo ou roteamento do Vertex AI, continue usando a plataforma para desenvolvedores do Google. Para uma compara\u00e7\u00e3o mais r\u00e1pida de criativos e menos abas abertas durante o desenvolvimento de prompts, <a href=\"https:\/\/www.glbgpt.com\/image-generator?inviter=hub_content_image&amp;login=1\" data-wpel-link=\"exclude\">\u00c1rea de trabalho do gerador de imagens do GlobalGPT<\/a> pode tornar os primeiros trabalhos menos desajeitados.<\/p>\n\n\n\n<h2 id=\"faq\" class=\"wp-block-heading\">PERGUNTAS FREQUENTES<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">A API Nano Banana Pro \u00e9 a mesma que a Gemini 3 Pro Image?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Para o trabalho de desenvolvimento, sim. O Google documenta o Nano Banana Pro como Gemini 3 Pro Image, e o ID do modelo na API \u00e9 <code>gemini-3-pro-image<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Devo usar o Nano Banana Pro ou o Nano Banana 2?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Use o Nano Banana Pro para imagens finais que exijam maior controle, texto leg\u00edvel, refer\u00eancias ou consist\u00eancia da marca. Use o Nano Banana 2 para rascunhos mais r\u00e1pidos e itera\u00e7\u00f5es mais econ\u00f4micas.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Posso chamar o Nano Banana Pro diretamente do JavaScript do front-end?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">N\u00e3o. Mantenha a chave da API no lado do servidor, encaminhe as solicita\u00e7\u00f5es pelo seu backend e aplique as cotas de usu\u00e1rio antes de enviar as solicita\u00e7\u00f5es para a API Gemini.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">O GlobalGPT substitui a API oficial do Google?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">O No. GlobalGPT \u00e9 \u00fatil para testes r\u00e1pidos e compara\u00e7\u00f5es criativas entre v\u00e1rios modelos, mas as chaves de API oficiais, o faturamento, os registros e os controles corporativos fazem parte da plataforma para desenvolvedores do Google.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Como devo estimar os custos da API Nano Banana Pro?<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Utilize a p\u00e1gina atual de pre\u00e7os da API Gemini do Google e fa\u00e7a uma estimativa com base no modelo, na resolu\u00e7\u00e3o de sa\u00edda e no volume de imagens. Uma estrat\u00e9gia comum de controle de custos \u00e9 fazer o rascunho inicialmente com o modelo de menor custo e, em seguida, utilizar o Nano Banana Pro para os ativos finais selecionados.<\/p>\n\n\n\n<script type=\"application\/ld+json\">{\n    \"@context\": \"https:\\\/\\\/schema.org\",\n    \"@type\": \"FAQPage\",\n    \"mainEntity\": [\n        {\n            \"@type\": \"Question\",\n            \"name\": \"Is Nano Banana Pro API the same as Gemini 3 Pro Image?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"For developer work, yes. Google documents Nano Banana Pro as Gemini 3 Pro Image, and the API model ID is gemini-3-pro-image.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"Should I use Nano Banana Pro or Nano Banana 2?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"Use Nano Banana Pro for final images that need tighter control, readable text, references, or brand consistency. Use Nano Banana 2 for faster drafts and cheaper iteration.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"Can I call Nano Banana Pro directly from frontend JavaScript?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"No. Keep the API key server-side, route requests through your backend, and apply user quotas before sending requests to the Gemini API.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"Does GlobalGPT replace the official Google API?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"No. GlobalGPT is useful for prompt testing and multi-model creative comparison, but official API keys, billing, logs, and enterprise controls belong in Google's developer platform.\"\n            }\n        },\n        {\n            \"@type\": \"Question\",\n            \"name\": \"How should I estimate Nano Banana Pro API costs?\",\n            \"acceptedAnswer\": {\n                \"@type\": \"Answer\",\n                \"text\": \"Use Google's current Gemini API pricing page and estimate by model, output resolution, and image volume. A common cost-control pattern is to draft with the lower-cost model first, then use Nano Banana Pro for selected final assets.\"\n            }\n        }\n    ]\n}<\/script>","protected":false},"excerpt":{"rendered":"<p>If you searched for &#8220;Nano Banana Pro API,&#8221; the first confusing bit is the name. The product name is Nano Banana Pro. The API name you actually use in code is gemini-3-pro-image. Once that is clear, the rest of the setup is much less mysterious. Use Nano Banana Pro when the image has to hold [&hellip;]<\/p>","protected":false},"author":5,"featured_media":4965,"comment_status":"closed","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"","_seopress_titles_title":"How to Use Nano Banana Pro\/Nano Banana 2 API \u2014 Step-by-Step Guide for Developers","_seopress_titles_desc":"Learn how to use Nano Banana Pro API step by step with this complete developer guide. Discover setup instructions, image generation, editing, advanced features, best practices, and real-world use cases for Nano Banana 2\/Pro API and Gemini 3 Pro AI.","_seopress_robots_index":"","footnotes":""},"categories":[8],"tags":[],"class_list":["post-4963","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-ai-image"],"_links":{"self":[{"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/posts\/4963","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/comments?post=4963"}],"version-history":[{"count":8,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/posts\/4963\/revisions"}],"predecessor-version":[{"id":17006,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/posts\/4963\/revisions\/17006"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/media\/4965"}],"wp:attachment":[{"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/media?parent=4963"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/categories?post=4963"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wp.glbgpt.com\/pt-br\/wp-json\/wp\/v2\/tags?post=4963"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}