Introdução
Nano Banana Pro Texto para imagem é o Gemini 3 Pro Image do Google, lançado em 20 de novembro de 2025, que gera imagens a partir de um prompt escrito. Ele raciocina sobre o pedido antes de desenhar, o que ajuda com texto denso, diagramas e layouts de várias partes, e renderiza em 1k, 2k ou 4k em dez proporções, 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 Pro Texto para imagem |
| uma imagem para mudar | Nano Banana Pro 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 Pro Image do Google com sua etapa de raciocínio.
Planeja antes de desenhar
O modelo define o layout primeiro, então prompts que dizem onde fica cada elemento ou citam várias linhas de texto voltam organizados como escritos. No nosso teste de capa, cada linha citada ficou onde o prompt a colocou.
Mesmo preço para 1k e 2k
O Google cobra 1K e 2K pelo mesmo preço, então a resolução 2k sai praticamente de graça e o 4k custa mais. A maioria das nossas renderizações em 2k voltou em 20 a 45 segundos.
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 dez proporções de 21:9 a 9:16; 16:9 por padrão. A proporção não altera o preço. |
resolution | Não | 1k (padrão), 2k ou 4k. 1k e 2k custam o mesmo; 4k custa mais e renderiza 4096 pixels no lado maior. |
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 recusadas não são cobradas.
| Especificação | Preço |
|---|---|
| $0.0668 / imagem (Com Official fallback: até $0.1072) |
| $0.0668 / imagem (Com Official fallback: até $0.1072) |
| $0.118 / imagem (Com Official fallback: até $0.192) |
Casos de uso
Retratos editoriais e de marca
Retratos que seguem uma lente, uma abertura e uma luz nomeadas, para apresentações, moodboards e rascunhos de campanha.
Layouts com texto
Pôsteres, capas, cardápios e sinalização em que vários textos dividem o quadro com uma foto e cada um precisa estar escrito corretamente.
Diagramas e infográficos
Diagramas com rótulos, gráficos simples e visuais passo a passo, em que o raciocínio ajuda a manter cada rótulo na parte certa.
Guia de prompt e dicas práticas
Escreva como uma lista de planos
Assunto, roupa, cenário, lente, abertura, direção da luz e tratamento de cor, nessa ordem e em frases completas.
Cite e posicione todo o texto
Toda palavra que deve aparecer vai entre aspas com uma posição; palavras sem aspas são lidas como descrição.
Comece em 2k
Neste modelo custa o mesmo que 1k, então gere em 2k por padrão e deixe o 4k para impressão.
Seja literal com a câmera
Uma lente de 85 mm em f/1.4 com luz de janela vinda da direita é seguida ao pé da letra; palavras vagas como cinematográfico deixam a escolha para o modelo.
Descreva as pessoas pelo que vestem e fazem
A pose, a roupa, a expressão e a posição de cada pessoa dão à etapa de planejamento o bastante para posicionar todos corretamente.
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-pro/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "16:9"
}
}'
# 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.
