API Nano Banana Pro
Adicione edição de imagem guiada por prompt ao seu produto com o GoEnhance. Envie de uma a quatro imagens de origem, escolha uma proporção de saída, receba um ID de tarefa e acompanhe a conclusão por polling ou callback HTTPS. O GoEnhance fornece acesso independente à API e não é a API oficial do Google.
Criar uma Chave de API
Criado para Edições de Imagem Guiadas por Referência
Prompt Mais Imagens de Origem
Descreva a alteração desejada no prompt e forneça de uma a quatro URLs de imagem HTTPS em image_list. Isso suporta edições que permanecem fundamentadas no material visual fornecido.
Entrega Assíncrona para Aplicativos de Produção
Persista o img_uuid retornado, consulte o endpoint de detalhes da tarefa ou receba alterações de status em uma URL de callback HTTPS pública. As tentativas de repetição de callback são feitas quando seu servidor não retorna HTTP 200.
Valide estas entradas antes de enviar uma solicitação de edição.
Parâmetros da API Nano Banana Pro
Endpoint
Envie solicitações POST para <code>https://api.goenhance.ai/api/v1/nano-banana/edit</code>.
Autorização
Inclua sua credencial de API do GoEnhance no cabeçalho <code>Authorization</code>.
Prompt
Uma string obrigatória que descreve a edição de imagem que você deseja que o modelo execute.
Lista de Imagens
Um array obrigatório contendo de 1 a 4 objetos de imagem de origem, cada um com uma URL de imagem acessível.
Proporção de Saída
Escolha <code>auto</code>, <code>1:1</code>, <code>16:9</code>, <code>9:16</code>, <code>4:3</code>, <code>3:4</code>, <code>2:3</code> ou <code>3:2</code>.
URL de Callback
Opcionalmente, forneça uma URL HTTPS pública para receber atualizações de processamento, sucesso e falha de status da tarefa.
Planeje cada solicitação de edição com base na cobrança documentada por imagem e na resposta assíncrona.
Preços Claros e Processamento de Tarefas
2 Tokens por Imagem
O preço da API Nano Banana Pro é de 2 tokens por imagem gerada, equivalente a $0.04 por imagem na documentação do GoEnhance.
Resposta do Identificador de Tarefa
Uma submissão bem-sucedida retorna um <code>img_uuid</code>. Armazene-o com o trabalho da sua aplicação para que você possa recuperar o resultado final.
Comportamento de Nova Tentativa de Callback
Se o seu callback não retornar HTTP 200, o GoEnhance tenta notificar novamente até três vezes com um tempo limite de três segundos por tentativa.
Integre a Edição Nano Banana em Três Passos
1
1. Prepare a Solicitação
Hospede de uma a quatro imagens de entrada em URLs HTTPS acessíveis, escreva um prompt de edição preciso, selecione uma proporção suportada e, opcionalmente, adicione uma URL de callback.
2
2. Envie e Persista
Envie o payload JSON via POST para o endpoint de edição com autorização, então armazene o
img_uuid retornado antes de responder ao seu usuário. 3
3. Resolva o Resultado
Consulte a API de detalhes da tarefa ou valide os eventos de callback até que o trabalho seja concluído com sucesso ou falhe, então salve a URL de saída retornada ou apresente a falha de forma segura.
Implemente fluxos de trabalho de edição de imagem controlados sem construir sua própria pilha de serviço de modelos.
Casos de Uso da API de Edição de Imagem
Variações de Cenário de Produto
Coloque uma imagem de produto existente em novos ambientes visuais, mantendo a fonte como contexto de edição.
Criação de Campanha
Gere variações visuais direcionadas por prompt para anúncios, banners e conceitos sazonais.
Reestilização de Personagem
Aplique mudanças de direção artística a referências de personagens ou retratos fornecidos com um prompt explícito.
Fluxos de Trabalho de E-commerce
Automatize mudanças de fundo, composição ou apresentação em imagens de catálogo.
Localização de Conteúdo
Adapte a direção da cena e o contexto visual para campanhas regionais, mantendo um ativo de origem consistente.
Prototipagem Criativa
Teste direções artísticas a partir de uma ou mais referências antes de se comprometer com um conceito de produção.
Respostas práticas para implementação, preços e intenção de busca da API do Google.