Introdução
Nano Banana Pro Edição de imagem aplica o Gemini 3 Pro Image do Google às imagens que você já tem. Aceita de uma a quatorze origens, planeja a edição antes de renderizar e devolve 1k, 2k ou 4k na proporção da origem ou numa das dez proporções.
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
Edições precisas de uma mudança só
Luz nova, fundo novo ou texto acrescentado enquanto as pessoas e o resto da imagem ficam como estavam, como nos nossos exemplos com velas e capa. O modelo planeja a edição antes de renderizar, o que mantém estáveis as partes da imagem que não mudam.
Texto sobre fotos
Títulos, linhas de edição e legendas são aplicados sobre a imagem com a grafia que você citar, na posição que você indicar.
Até quatorze referências
Junte pessoas, produtos e cenários de muitas origens, cada uma descrita pelo seu papel no prompt, numa única solicitação de ediçã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 |
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 dez proporções de 21:9 a 9:16. 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 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 8 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. O orçamento mostra o preço inicial e o valor máximo da edição. 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
Transformar fotos em capas e pôsteres
Acrescente um título, uma data e uma linha de texto a uma foto aprovada sem retocá-la.
Variações de clima e luz
Mostre a mesma cena à luz de velas, ao amanhecer ou sob neon para um cliente que está escolhendo uma direção.
Imagens de campanha localizadas
Troque o texto de um pôster pronto por uma linha traduzida para cada mercado, mantendo a foto e a luz intactas.
Guia de prompt e dicas práticas
Mude uma coisa de cada vez
Instruções com uma única mudança mantêm todo o resto estável; encadeie edições em vez de juntá-las num só prompt.
Proteja as pessoas
Depois da mudança, nomeie a pessoa, a roupa e a pose que devem ficar exatamente iguais.
Conte com o tempo das edições
Neste modelo, as edições levam mais tempo que o texto para imagem: até cerca de três minutos nos nossos testes em 2k na rota oficial, enquanto as nossas edições em 1k na rota econômica terminaram em menos de um minuto.
Cite o texto com a posição
Para texto acrescentado, cite cada linha e diga onde ela fica: no alto, no canto inferior esquerdo, ao lado do logo.
Use 2k por padrão
Neste modelo, 1k e 2k custam o mesmo, então edite em 2k a menos que você precise de um arquivo menor.
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/edit",
"input": {
"aspect_ratio": "auto",
"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.
