Introdução
Nano Banana 2.1 Edição de imagem aplica o modelo Nano Banana mais novo do Google às imagens que você já tem. Aceita de uma a catorze origens, mantém a proporção da origem ou reenquadra para uma de catorze proporções, e renderiza em 1k, 2k ou 4k. O Google criou esta atualização pensando na edição conversacional, com personagens mais estáveis entre edições e texto mais preciso.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | Nano Banana 2.1 Texto para imagem |
| imagens para mudar ou combinar | Nano Banana 2.1 Edição de imagem |
Recursos e destaques
Até quatorze referências
Junte pessoas, peças de roupa, produtos e cenários de até quatorze imagens. O Google indica o modelo para até quatro personagens consistentes e dez objetos numa mesma fusão. Na nossa edição com três imagens, o rosto do homem e os botões de latão e os bolsos da jaqueta foram mantidos.
Rostos preservados em grandes mudanças
Uma foto diurna de uma estufa virou uma noite na ópera com vestido novo, penteado novo e sala nova, e o rosto continuou sendo o dela.
Texto desenhado dentro da cena
O encarte em branco de um álbum, segurado numa foto, ganhou um projeto de capa completo com o título e o nome da banda entre aspas, sem alterar as pessoas que o seguravam.
Reenquadre enquanto edita
A proporção auto mantém o formato da origem; qualquer uma das catorze proporções reenquadra o resultado. Com várias origens de formatos diferentes, defina você mesmo a proporção.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Diga o que muda e depois liste o que deve ficar igual; chame as origens de primeira imagem, segunda imagem e assim por diante. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De 1 a 14 imagens de origem, na ordem a que seu prompt se refere. pelo menos 1 itens · no máximo 14 itens |
aspect_ratio | Não | auto (padrão) mantém a proporção da imagem de origem; com várias origens, escolha uma proporção explicitamente. Há catorze proporções disponíveis, incluindo 4:1, 1:4, 8:1 e 1:8. |
resolution | Não | 1k (padrão), 2k ou 4k. Um quadro quadrado tem 1024, 2048 ou 4096 pixels de lado; cada nível tem seu próprio preço. |
enable_web_search | Não | Desligada por padrão. Quando ligada, o modelo confere fatos atuais antes de desenhar. Valor padrão: |
enable_image_search | Não | Desligada por padrão. Quando ligada, o modelo busca imagens de referência na web, útil quando a edição acrescenta um lugar ou produto real que você não enviou. Valor padrão: |
output_format | Não | png (padrão) ou jpeg. Os arquivos JPEG são várias vezes menores; o preço é o mesmo. |
official_fallback | Não | Ligado por padrão. Cada edição roda primeiro na rota econômica. Valor padrão: |
Preços
Cobrado por imagem conforme o nível de tamanho. Cada edição começa na rota econômica, pelo preço econômico. Com o Official fallback (ligado por padrão), uma edição que a rota econômica recusa ou não consegue concluir, ou que tem mais de 10 imagens de origem, passa pela rota oficial pelo preço oficial, que também acrescenta uma pequena taxa fixa por imagem de origem; desligue-o para pagar só o preço econômico. Edições com busca na web ou busca de imagens passam pela rota oficial, e cada busca acrescenta uma taxa. O orçamento mostra o preço inicial e o valor máximo da edição. Edições recusadas não são cobradas. Uma edição que o modelo suaviza ainda devolve uma imagem e é cobrada como qualquer outra.
| Especificação | Preço |
|---|---|
| $0.0217 / imagem (Com Official fallback: até $0.048) |
| $0.0351 / imagem (Com Official fallback: até $0.072) |
| $0.0626 / imagem (Com Official fallback: até $0.162) |
Casos de uso
Provas de roupa e de produto
Coloque uma peça, uma bolsa ou um produto de uma foto de catálogo numa pessoa de outra foto, no cenário que você escolher.
Mudança de lugar e de hora do dia
Leve uma pessoa para um lugar novo ou transforme dia em noite para uma campanha, mantendo o rosto.
Mockups de embalagem e sinalização
Desenhe rótulos, encartes, letreiros e pôsteres direto numa foto existente, com o texto entre aspas.
Guia de prompt e dicas práticas
Nomeie cada origem pela posição
Fale da primeira imagem, da segunda imagem, da terceira imagem e diga o que cada uma traz: a pessoa, a peça de roupa, a sala.
Liste o que deve ficar
Depois de descrever a mudança, nomeie o que fica: o rosto, a cor do cabelo, os botões da jaqueta. O modelo respeita uma lista escrita.
Mantenha os pedidos dentro da política do Google
A edição é mais rígida do que texto para imagem: a troca de roupa de nível Leve foi recusada, enquanto um vestido de noite sem costas passou. Edições recusadas não são cobradas.
Rascunho em 1k
Teste primeiro a instrução em 1k; se a mudança sair certa, rode o mesmo pedido em 2k ou 4k.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2.1/edit",
"input": {
"aspect_ratio": "auto",
"enable_image_search": false,
"enable_web_search": false,
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.









