API Nano Banana 2 Edit
Integre a edição de imagens guiada por referências pela GoEnhance. Envie de uma a nove imagens de origem com um prompt, escolha o tamanho de saída e a proporção e obtenha o resultado por polling ou callback HTTPS. A GoEnhance oferece acesso independente à API e não é a API Gemini oficial do Google.
Criar uma API Key
Edição guiada por referências para fluxos de desenvolvimento
Um prompt e até nove imagens
Informe um prompt de 1–2000 caracteres e de uma a nove URLs de imagem acessíveis em image_list. Escolha uma proporção compatível e o tamanho de saída 0.5K, 1K, 2K ou 4K.
Resultados assíncronos para aplicações em produção
Um envio bem-sucedido retorna um img_uuid. Guarde esse valor, faça polling em /api/v1/jobs/detail ou receba eventos de status da tarefa em uma URL de callback HTTPS pública.
Confira o contrato real da requisição antes de enviar uma edição.
Parâmetros da API Nano Banana 2 Edit
Endpoint
Envie requisições POST para <code>https://api.goenhance.ai/api/v1/nano-banana-2/edit</code>.
Autorização
Inclua a credencial da sua API GoEnhance no cabeçalho <code>Authorization</code>.
Prompt
Informe uma instrução de edição obrigatória com 1 a 2000 caracteres.
Lista de imagens
Envie um array obrigatório com 1–9 objetos de imagem com URLs acessíveis.
Proporção
Escolha <code>auto</code> ou uma proporção documentada, de <code>1:1</code> até formatos largos como <code>21:9</code>, <code>4:1</code> e <code>8:1</code>.
Controles de saída
Selecione <code>0.5k</code>, <code>1k</code>, <code>2k</code> ou <code>4k</code>; opcionalmente defina <code>web_search</code>, <code>thinking_level</code> e uma URL de callback HTTPS pública.
A cobrança é por imagem gerada e varia conforme o tamanho de saída solicitado.
Preços da API Nano Banana 2 Edit
0.5K e 1K
<code>0.5k</code> custa 3 tokens ($0.060) por imagem; <code>1k</code> custa 3.3 tokens ($0.066) por imagem.
2K e 4K
<code>2k</code> custa 5 tokens ($0.100) por imagem; <code>4k</code> custa 7.5 tokens ($0.150) por imagem.
Resposta assíncrona
O envio retorna um <code>img_uuid</code>, não a imagem final. Obtenha o resultado definitivo por polling ou callback.
Integre o Nano Banana 2 Edit em três passos
1
1. Prepare a edição
Hospede de uma a nove imagens de origem em URLs acessíveis, escreva um prompt preciso, escolha a proporção e o tamanho da imagem e, se quiser, configure um callback.
2
2. Envie e guarde o ID
Faça o POST do payload JSON com a autorização, valide a resposta e guarde o
img_uuid retornado junto com o job da sua aplicação. 3
3. Obtenha o resultado
Faça polling no endpoint de detalhes da tarefa ou valide os eventos de callback até a tarefa concluir ou falhar; depois salve a saída ou exiba a falha com segurança.
Construa recursos de edição de imagem em torno de assets de origem e prompts explícitos.
Casos de uso da API Nano Banana 2 Edit
Novos cenários de produto
Coloque as imagens de produto enviadas em um novo cenário mantendo o contexto da origem.
Variações de campanha
Gere variações criativas orientadas por prompt para campanhas sazonais e por canal.
Composição com múltiplas referências
Use várias imagens de origem quando a edição depender de mais de uma referência visual.
Produção para e-commerce
Automatize edições de fundo, estilo ou apresentação em todos os fluxos de catálogo.
Criação localizada
Adapte a direção de cena e o contexto visual para campanhas regionais a partir de assets aprovados.
Prototipagem criativa
Teste novas direções de arte a partir de referências existentes antes de levar para produção.
Respostas sobre preços, entradas, entrega assíncrona e a relação com a API do Google.