Nano Banana Pro API

Imagem de IA

A API do Nano Banana Pro traz a rota de imagem Gemini 3 Pro de maior fidelidade do Google na OmniaKey, feita para texto para imagem detalhado e edições por referência que exigem raciocínio.

Ler a documentação Obtenha sua chave API

Por chamada bem-sucedida$0,039–$0,069
OperaçõesTexto para imagem
Edição de imagem
IDsgemini-3-pro-image-preview
Ver preços de ferramentas e regras de cobrança

Seu resultado aparecerá aqui quando você executar o modelo.

Onde ele se encaixa

A API do Nano Banana Pro traz a rota de imagem Gemini 3 Pro de maior fidelidade do Google na OmniaKey, feita para texto para imagem detalhado e edições por referência que exigem raciocínio.

Escolha o Nano Banana Pro para composições complexas e edições que precisem de um modelo mais forte, e desça para o Nano Banana 2 em geração de alto volume, em que o custo por chamada manda.

Os dois IDs chamam o mesmo produto com os mesmos recursos e o mesmo preço. Você pode usar qualquer um deles.

O que ele faz

Texto para imagem

gemini-3-pro-image

Transforma um texto em uma nova imagem.

Edição de imagem

gemini-3-pro-image

Altera uma imagem existente a partir de um texto e uma referência.

Em detalhe

O Nano Banana Pro é o modelo de imagem Gemini de maior fidelidade do Google no OmniaKey, vendido como gemini-3-pro-image, com gemini-3-pro-image-preview aceito como ID equivalente. Ele cobre texto para imagem e edição de imagem. Ocupa o nível mais alto entre os IDs de imagem Gemini listados aqui, e a tabela de níveis tem uma peculiaridade que vale conhecer: as entradas de 1K e 2K ficam no mesmo valor, então o tamanho intermediário é a forma mais barata de alcançar o detalhe dele.

Onde o nível extra entrega algo é no detalhe físico. O Pro foi o único dos três modelos que desenhou poeira suspensa num feixe de luz mantendo as prateleiras suaves e as mãos nítidas, e numa natureza-morta em par retornou um JPEG de 545.484 bytes reportando 450 tokens. Ao mover uma pessoa para uma nova cena, manteve cada detalhe listado, empate com o Nano Banana 2. Layouts são o lado mais fraco: as duas execuções de pôster voltaram como mockup numa parede.

A direção da luz é a surpresa recorrente. Pedido para um frasco de perfume iluminado pela direita, o Pro deu o espaço para texto mais limpo dos três e depois colocou a luz à esquerda, então espelhar o quadro para corrigir também teria espelhado a palavra gravada. O resto segue o padrão da família: uma imagem por chamada, cobrança definida pelo nível de saída, no topo da faixa aqui.

Textura e luz fotorrealistas

Cerâmica, vidro, poeira e pele: recorra ao Pro quando um quadro precisa parecer fotografado e não renderizado. Nossa cena da ceramista foi a única entre três em que a poeira ficou suspensa na luz com prateleiras suaves e mãos nítidas. Nomeie a fonte de luz e o material, depois inspecione bordas e realces em tamanho real.

Edições que preservam a pessoa

No nosso teste de mesma pessoa em nova cena, o Pro manteve cada detalhe listado e empatou com o outro modelo limpo. Envie a imagem de referência do rosto como entrada separada, liste as marcas que precisam sobreviver e compare o resultado com a referência antes de aprovar, porque uma semelhança convincente não é o mesmo que uma semelhança fiel.

Quadros de produto com espaço para texto

A vantagem dele em trabalho de produto é o espaço para tipografia: a foto do perfume deixou a área mais limpa para texto entre as três que executamos. Posicione o assunto fora do centro no prompt, diga de que lado vem a luz e planeje espelhar o quadro você mesmo quando o modelo inverter.

Notas de teste

No nosso teste de foto da ceramista, o Nano Banana Pro foi o único dos três modelos que desenhou poeira na luz junto com prateleiras suaves e mãos nítidas.
Ler o teste
No nosso teste de pôster, o Nano Banana Pro manteve o texto exato de duas linhas nas duas execuções, mas retornou o pôster como mockup de parede nas duas vezes.
Ler o teste
O Nano Banana Pro deu o espaço para texto mais limpo na nossa foto de produto de perfume, mas colocou a luz à esquerda, o oposto do prompt.
Ler o teste
No nosso caso de natureza-morta em par, o mesmo prompt no Nano Banana Pro retornou um JPEG de 545.484 bytes e reportou 450 tokens.
Ler o teste
Nos seis testes em 16 de outubro de 2026, o Nano Banana Pro foi o mais lento dos três modelos Gemini, com mediana de 33 segundos por imagem.
Ler o teste

Limites a considerar

A direção da luz não segue o prompt. Nosso pedido do perfume pedia luz pela direita e o Pro iluminou pela esquerda, então uma correção espelhada também teria invertido a palavra gravada.
Pôsteres chegam como fotografias de um pôster: as duas execuções voltaram como mockup numa parede, então planeje um recorte ou uma composição antes de o arquivo ir para impressão.
É o nível mais alto entre os IDs de imagem Gemini listados aqui em 1K e 4K, enquanto 1K equivale a 2K, então um rascunho pequeno é a forma menos eficiente de usar o modelo.
O limite de referências é desigual: o guia do Google permite seis imagens de objeto e cinco de personagem, contra dez e quatro no Nano Banana 2.1, então fotos de grupo exigem uma escolha.

Comparar modelos próximos

Modelo	Melhor para	Operações	Preço divulgado
Nano Banana ProEsta página gemini-3-pro-image	Naturezas-mortas sensíveis à marca e edições de retrato em que detalhe físico e marcas preservadas decidem a revisão.	Texto para imagem · Edição de imagem	$0,039–$0,069 por chamada
Nano Banana 2.1 gemini-nano-banana-2.1	Geração geral e trabalho de layout num nível listado mais baixo em todos os tamanhos, com saída de pôster mais limpa.	Texto para imagem · Edição de imagem	$0,019–$0,039 por chamada
Nano Banana 2 gemini-3.1-flash-image	Geração em alto volume na base da faixa, agora descontinuada pelo Google mas ainda ativa.	Texto para imagem · Edição de imagem	$0,019–$0,039 por chamada

Fontes e verificação

Guia atualizado em 2026-10-27.

Como chamar

Os modelos de mídia funcionam de forma assíncrona: crie uma tarefa, consulte até terminar e baixe a URL assinada do recurso.

Criar, consultar, baixar

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gemini-3-pro-image-001" \
  -d '{
    "model": "gemini-3-pro-image",
    "type": "image",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"aspect_ratio": "1:1"}
  }'

# 2. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 3. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"

Preço

Trabalhos de imagem são cobrados por chamada bem-sucedida, não por token. Trabalhos com falha ou cancelados são reembolsados automaticamente.

Por chamada bem-sucedida

$0,039–$0,069por chamadaEconomize 71%

image_size

1K: $0,039por chamada
2K: $0,039por chamada
4K: $0,069por chamada

Mais modelos de imagem Google

Nano Banana 2

gemini-3.1-flash-image

Nano Banana 2.1

gemini-nano-banana-2.1

Nano Banana 2 Lite

gemini-3.1-flash-lite-image

Perguntas frequentes

Como chamo Nano Banana Pro na OmniaKey?

Envie um POST para /v1/media/tasks com o id do modelo, type "image" e operation "generate" ou "edit". Reutilize a mesma Idempotency-Key nas tentativas para que um timeout nunca inicie um segundo trabalho cobrado.

Quanto custa o Nano Banana Pro?

O Nano Banana Pro é cobrado a $0,039–$0,069 por chamada. A criação pré-cobra esse valor do seu saldo pré-pago, e trabalhos com falha ou cancelados são reembolsados automaticamente.

Por que a API retorna um id de tarefa em vez da imagem?

A latência dos provedores varia de segundos a cerca de um minuto, então a OmniaKey normaliza todas as rotas de imagem em um único fluxo assíncrono. Consulte GET /v1/media/tasks/{id} até o status ser succeeded e leia a URL assinada do recurso.

Pro ou 2.1 para um ativo sensível à marca?

Pro se um detalhe errado forçar outra revisão: foi o único modelo no nosso teste triplo a desenhar poeira na luz com prateleiras suaves e mãos nítidas, e manteve cada detalhe facial listado no caso de nova cena. O 2.1 vem logo atrás e levou o infográfico e a foto de produto. Teste o briefing que você realmente entrega.

Qual ID do modelo o Pro usa?

gemini-3-pro-image, com gemini-3-pro-image-preview aceito como ID equivalente no catálogo. Mantenha esse ID separado de rótulos de consumidor do Gemini como Pro ou Thinking, que nomeiam modos no aplicativo e não modelos de API, e cite o ID exatamente no corpo da tarefa.

Por que meu pôster virou uma foto de um pôster?

As duas execuções de pôster voltaram como mockup pendurado numa parede, mesmo com as duas linhas de texto exatas. Peça um arquivo plano no prompt e, quando um mockup voltar, recorte ou componha a arte você mesmo; o texto ainda serve como camada.

Como o Nano Banana Pro é cobrado?

Uma imagem por chamada, pela tarifa da tabela de preços na página do modelo, que varia por tamanho de saída: 1K e 2K compartilham um valor e 4K fica acima deles, o nível mais alto listado entre os IDs de imagem Gemini aqui. Uma tarefa com falha devolve o crédito reservado, e uma requisição retorna uma imagem.

Quantas imagens de referência posso anexar?

Até 14 no total, divididas em seis imagens de objeto e cinco de personagem no guia de imagem do Google, onde o Nano Banana 2.1 permite dez objetos e quatro personagens. Uma foto de grupo, portanto, pede uma decisão sobre quem recebe uma referência em vez de uma lista maior.