Introdução
Nano Banana 2.1 Texto para imagem é o modelo Nano Banana mais novo do Google, lançado em 6 de outubro de 2026 como atualização do Nano Banana 2 (Gemini 3.1 Flash Image). O Google melhorou a qualidade visual, a fidelidade ao prompt e o texto na imagem, e diz ter corrigido as emendas que banners largos mostravam em 2K e 4K. Renderiza em 1k, 2k ou 4k em catorze proporções de até 8:1 e pode buscar na web ou em imagens de referência antes de desenhar.
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
Texto que sai certo
Nos nossos testes toda linha que pusemos entre aspas saiu escrita como pedido: o logotipo de uma revista e duas chamadas de capa, o título de um filme e sua linha de estreia, um letreiro de néon de motel. As letras miúdas que não escrevemos, como as linhas finas sob o título de um filme, voltaram como enchimento.
Catorze proporções, três tamanhos
De quadros de stories 1:8 a banners 8:1, em 1k, 2k ou 4k. A proporção nunca muda o preço; só o nível de tamanho. Nosso banner 8:1 em 2k voltou com 5856 pixels de largura. Se um formato largo volta como uma imagem só depende das pessoas nele: nas nossas execuções, paisagens e multidões ficaram inteiras, enquanto pessoas espalhadas pelo quadro ou perto da câmera muitas vezes voltaram como tomadas coladas.
Busca antes de desenhar
A busca na web traz fatos atuais, como datas, clima e eventos; a busca de imagens traz imagens de referência de lugares e produtos reais. Nosso pôster de previsão imprimiu a data de hoje com a busca na web ligada e uma data inventada sem ela.
PNG ou JPEG
PNG é o padrão; os arquivos JPEG são várias vezes menores pelo mesmo preço.
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 simples; palavras entre aspas duplas são impressas na imagem. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Uma de catorze proporções, 16:9 por padrão; a proporção não altera o preço. |
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, como datas, clima ou eventos, 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: |
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 requisição roda primeiro na rota econômica. Valor padrão: |
Preços
Cobrado por imagem conforme o nível de tamanho; a proporção e o formato de saída não alteram o preço. Cada solicitação começa na rota econômica, pelo preço econômico. Com o Official fallback (ligado por padrão), uma solicitação que a rota econômica recusa ou não consegue concluir é executada de novo na rota oficial pelo preço oficial, então o orçamento mostra o preço inicial e o valor máximo; desligue-o para pagar só o preço econômico. Solicitações com busca na web ou busca de imagens passam pela rota oficial, e cada busca acrescenta uma taxa. Uma solicitação que o modelo suaviza ainda devolve uma imagem e é cobrada como qualquer outra. Pedidos recusados não são cobrados.
| 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
Capas e pôsteres
Capas de revista, pôsteres de cinema e flyers de eventos em que a manchete precisa sair certa de primeira.
Cabeçalhos de site
Cabeçalhos ultralargos 4:1 e 8:1 de paisagens, portos, skylines e multidões, conferidos em busca de painéis colados antes do uso. Para pessoas em close, gere 21:9 em 4k e recorte para 4:1. Os quadros altos 1:4 e 1:8 funcionam quando o próprio assunto é alto, como um farol, um arranha-céu ou uma cachoeira.
Editoriais de moda e lifestyle
Traje de noite, moda editorial e casais saem como pedido; pedidos a partir do nível Forte, não.
Imagens que dependem de hoje
Cards de previsão, programações e pôsteres de eventos, com a busca na web ligada para que os dados estejam atuais.
Guia de prompt e dicas práticas
Coloque as palavras entre aspas e descreva a tipografia
Coloque cada linha de texto entre aspas duplas e diga o estilo e o lugar: maiúsculas serifadas altas no topo, sans serif condensada em negrito embaixo.
Mantenha as pessoas pequenas nos quadros largos
Em 4:1 e 8:1, deixe um só cenário preencher toda a largura, como uma serra, um porto ou uma multidão, e mantenha as pessoas pequenas e perto do centro. Os prompts que voltaram como tomadas coladas foram os que espalhavam pessoas pelo quadro ou as punham perto da câmera; começar com "one continuous scene" não impediu isso.
Reserve a busca para fatos
A busca na web ajuda quando a imagem depende de algo atual ou real. Ela não melhora estilo nem composição, então deixe-a desligada nos outros casos.
Rascunho em 1k, entrega em 2k
Defina a composição em 1k e depois rode o mesmo prompt em 2k; deixe o 4k para impressão e recortes fortes.
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9",
"output_format": "png",
"enable_web_search": false,
"enable_image_search": false
}
}'
# 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.









