Introdução
Nano Banana 2 Texto para imagem é o Gemini 3.1 Flash Image do Google, lançado em 26 de fevereiro de 2026, que gera imagens a partir de um prompt escrito. O Google o descreve como qualidade de imagem de nível Pro na velocidade do Flash. Renderiza em quatro níveis de tamanho de 0.5k a 4k, em quatorze proporções até 8:1, e pode buscar na web e em imagens de referência antes de desenhar, a partir de bem abaixo das tarifas do Google.
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
Rota econômica e Official fallback
Os pedidos começam numa rota econômica, por um preço bem abaixo da tabela do Google. Com o Official fallback (ligado por padrão), um pedido que ela não consegue concluir é executado de novo na rota oficial pelo preço oficial. Nos dois casos o modelo é o Gemini 3.1 Flash Image do Google, com os níveis de tamanho que o Google publica para o Nano Banana 2.
Quatro níveis, quatorze proporções
De rascunhos de 512 px a finais de 4096 px, e de torres 1:8 a banners 8:1. A proporção nunca muda o preço, só o nível de tamanho. Em 2k, nosso banner 4:1 voltou com 4128 pixels de largura.
Busca antes de desenhar
A busca na web traz fatos atuais, como datas, clima e pontos turísticos; a busca de imagens traz fotos de referência de lugares e produtos reais. As duas são chaves opcionais por solicitaçã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 completas; palavras entre aspas são desenhadas como texto na imagem. pelo menos 1 caracteres · no máximo 5000 caracteres |
aspect_ratio | Não | Uma de quatorze proporções, incluindo os banners extremos 4:1, 1:4, 8:1 e 1:8; 16:9 por padrão. 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 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 não altera 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 em 0.5k ou com busca na web ou busca de imagens passam pela rota oficial, e cada busca acrescenta uma taxa. 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
Cabeçalhos de site e outdoors
Banners ultralargos 4:1 e 8:1 renderizados como uma única foto contínua, sem emendar ou esticar depois.
Rascunhos rápidos de moda e lifestyle
Muitas direções por hora em 0.5k e 1k, com a melhor refeita em 2k para entrega.
Lugares e produtos reais
Com a busca de imagens ligada, cenas diante de um ponto turístico real ou com um produto real podem se apoiar em fotos de referência da web.
Formatos altos para celular
Imagens altas 1:4 e 1:8 para stories e banners laterais, geradas como uma única imagem contínua.
Guia de prompt e dicas práticas
Dê conteúdo às duas bordas nos formatos largos
Em 4:1 e 8:1, descreva o que preenche as bordas esquerda e direita: uma praia longa, um skyline, uma fileira de vitrines. Senão as pontas viram céu vazio.
Busca para fatos, não para estilo
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 pequeno, entrega grande
Mantenha o mesmo prompt de 0.5k a 4k; a composição fica parecida, então as escolhas feitas no rascunho continuam valendo.
Escolha 2k para entrega
Em 2k, uma imagem quadrada tem 2048 pixels de lado, o suficiente para a maioria das telas e páginas; 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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9",
"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.
