Introdução
Nano Banana 2 Edição de imagem aplica o Gemini 3.1 Flash Image do Google às imagens que você já tem. Aceita de uma a quatorze origens, mantém a proporção da origem ou a muda para uma das quatorze proporções, e renderiza em 0.5k, 1k, 2k ou 4k.
Escolha o modo pelo material de partida
| O que você tem | Modo |
|---|---|
| um briefing escrito | Nano Banana 2 Texto para imagem |
| uma imagem para mudar | Nano Banana 2 Edição de imagem |
Recursos e destaques
Até quatorze referências
Junte pessoas, roupas, cenários e produtos de até quatorze imagens, cada uma descrita pelo seu papel no prompt. A rota econômica aceita até dez; com mais, a edição passa pela rota oficial, onde cada origem acrescenta uma pequena taxa fixa, então passe só as que a edição precisa.
Reenquadre enquanto edita
A proporção auto mantém o formato da origem; uma das quatorze proporções reenquadra o resultado, como no nosso exemplo em que um banner 4:1 virou uma cena noturna 16:9.
Rápido em qualquer tamanho
Os mesmos níveis do texto para imagem, de rascunhos em 0.5k a finais em 4k, com preço pelo nível; na rota oficial, cada origem acrescenta uma pequena taxa.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Descreva assunto, cenário, luz e lente em frases completas; palavras entre aspas são desenhadas como texto na imagem. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De 1 a 14 imagens de origem. Diga no prompt o que cada uma traz: a pessoa, o cenário, o produto. 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; ou escolha uma de quatorze proporções, incluindo os banners extremos 4:1, 1:4, 8:1 e 1:8. A proporção não altera o preço. |
resolution | Não | 0.5k, 1k (padrão), 2k ou 4k. Uma imagem quadrada tem 512, 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, como clima, datas ou pontos turísticos, 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 antes de desenhar, útil para lugares e produtos reais. Valor padrão: |
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, sem taxa por imagem de origem. 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 em 0.5k ou 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. Na rota oficial, uma recusa que volta como uma resposta curta em texto no lugar da imagem conta como uma geração concluída e é cobrada pelo preço oficial; as demais recusas não são cobradas.
| Especificação | Preço |
|---|---|
| $0.036 / imagem |
| $0.0384 / imagem (Com Official fallback: até $0.0536) |
| $0.0602 / imagem (Com Official fallback: até $0.0808) |
| $0.0902 / imagem (Com Official fallback: até $0.1208) |
Casos de uso
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 rosto, roupa e pose.
Adaptar imagens prontas a outros formatos
Transforme um banner largo numa versão 16:9 ou 9:16 com conteúdo novo nas bordas em vez de um simples recorte.
Composições de produto
Arrume várias fotos de produto numa única cena produzida, nomeando cada produto e onde ele fica.
Guia de prompt e dicas práticas
Liste o que deve ficar
Depois de descrever a mudança, nomeie o rosto, o cabelo, a roupa e a pose a manter; o modelo respeita uma lista escrita.
Descreva o novo enquadramento ao reenquadrar
Quando a proporção mudar, diga o que deve ocupar o espaço extra: mais céu, outra mesa, o resto da rua.
Busca só para referências reais
Ligue a busca de imagens apenas quando a edição depender de um lugar ou produto real que o modelo precisa ver.
Teste as edições em 0.5k
Teste a instrução em 0.5k primeiro; se a edição funcionar, rode a mesma solicitação em 2k ou 4k.
Ajuste o nível à origem
Uma edição não acrescenta detalhes que a origem nunca teve; 2k costuma bastar, a menos que a própria origem seja grande.
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/edit",
"input": {
"aspect_ratio": "auto",
"enable_image_search": false,
"enable_web_search": false,
"image_urls": [
"https://example.com/reference.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.
