Nano Banana 2 API
Gere imagens a partir de texto com o Nano Banana 2 pela API independente do GoEnhance. Escolha uma proporção compatível e um tamanho de saída de 0.5K–4K e depois faça polling ou receba callbacks com o resultado. O GoEnhance não é o Google, e este endpoint não é a API oficial do Gemini do Google.
Criar uma API Key
Geração flexível de texto para imagem
Controle de prompt e de saída
Envie model com o valor nano-banana-2 e um prompt de 1–2000 caracteres. Escolha uma proporção documentada, um tamanho de saída e, se quiser, a profundidade de raciocínio.
Entrega assíncrona da tarefa
Um envio bem-sucedido retorna img_uuid. Faça polling em GET /api/v1/jobs/detail ou informe uma URL de callback HTTPS de acesso público para receber as atualizações de status.
Confira o ID exato do modelo e os campos documentados antes de enviar uma tarefa de geração.
Parâmetros da API Nano Banana 2
Modelo
Obrigatório. Defina <code>model</code> exatamente como <code>nano-banana-2</code>.
Prompt
Descrição em texto obrigatória, de 1 a 2000 caracteres.
Proporção da imagem
Parâmetro opcional <code>ratio</code>. Os valores aceitos são auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 4:5, 5:4, 21:9, 1:4, 4:1, 1:8 e 8:1.
Tamanho da imagem
O parâmetro opcional <code>image_size</code> tem o valor padrão <code>1k</code>; os valores disponíveis são <code>0.5k</code>, <code>1k</code>, <code>2k</code> e <code>4k</code>.
Controles de geração
Entre os controles opcionais estão <code>web_search</code> e os valores de <code>thinking_level</code>, que diferenciam maiúsculas de minúsculas: <code>High</code> ou <code>Minimal</code>.
Autorização e callback
Envie o cabeçalho <code>Authorization</code>. A <code>custom_callback_url</code> opcional precisa ser uma URL HTTPS de acesso público.
A cobrança é por imagem gerada e varia conforme o tamanho de saída solicitado.
Preços e comportamento das tarefas da API Nano Banana 2
Preços de 0.5K e 1K
0.5K custa 3 tokens ($0.060) por imagem. 1K custa 3,3 tokens ($0.066) por imagem.
Preços de 2K e 4K
2K custa 5 tokens ($0.100) por imagem. 4K custa 7,5 tokens ($0.150) por imagem.
Resultado assíncrono
O envio retorna <code>img_uuid</code>, não a imagem final. Faça polling no endpoint de detalhe da tarefa ou trate os eventos de callback para obter o resultado final.
Integre o Nano Banana 2 em três passos
1
1. Envie uma requisição de geração
Faça um POST JSON para
https://api.goenhance.ai/api/v1/images/generations com a autorização, model, prompt e os campos opcionais de proporção, tamanho, busca na web, raciocínio ou callback. 2
2. Guarde o img_uuid
Leia
data.img_uuid na resposta bem-sucedida e associe esse valor à requisição do seu aplicativo. 3
3. Faça polling ou receba callbacks
Faça polling em
GET /api/v1/jobs/detail ou processe os eventos de callback. O GoEnhance documenta até três novas tentativas de callback quando seu endpoint não retorna HTTP 200, com tempo limite de três segundos por tentativa.Monte fluxos controlados de geração de imagens enquanto seu aplicativo cuida dos prompts, da revisão, do armazenamento e da entrega.
Casos de uso da API Nano Banana 2
Ilustração editorial
Transforme briefings estruturados de pauta em imagens candidatas para uma fila de revisão humana.
Narrativa de produto
Gere conceitos de cena a partir de descrições de produto para revisão posterior de marca e conformidade.
Variações de campanha
Crie variações de prompt e de proporção acompanhando cada tarefa assíncrona de forma independente.
Fluxos de localização
Produza conceitos visuais específicos de cada região a partir de prompts localizados, sem mudar a arquitetura que trata suas tarefas.
Desenvolvimento de conceito
Explore personagens, objetos de cena, ambientes e direções de arte antes de fechar os assets de produção.
Pipelines criativos automatizados
Conecte os callbacks a serviços de moderação, aprovação, armazenamento ou processamento posterior de assets.
Respostas práticas sobre preços, parâmetros, entrega assíncrona e a relação com a API do Google.