Nano Banana 2 API

Imagem de IA

A API do Nano Banana 2 traz a rota de imagem rápida Gemini 3.1 Flash do Google na OmniaKey: geração por texto e edição por referência a preço baixo por chamada.

Ler a documentação Obtenha sua chave API

Por chamada bem-sucedida$0,019–$0,039
OperaçõesTexto para imagem
Edição de imagem
IDsgemini-3.1-flash-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 2 traz a rota de imagem rápida Gemini 3.1 Flash do Google na OmniaKey: geração por texto e edição por referência a preço baixo por chamada.

Recorra ao Nano Banana 2 quando quiser geração de imagens Gemini rápida e barata dentro de um produto ou agente, e suba para o Nano Banana Pro quando uma edição exigir mais raciocínio.

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.1-flash-image

Transforma um texto em uma nova imagem.

Edição de imagem

gemini-3.1-flash-image

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

Em detalhe

O Gemini 3.1 Flash Image é o modelo de imagem do Gemini da Google no OmniaKey sob o ID gemini-3.1-flash-image, conhecido na família como Nano Banana 2. Ele gera e edita imagens, e gemini-3.1-flash-image-preview é aceito como ID equivalente. Ele compartilha as mesmas faixas por chamada listadas do Nano Banana 2.1, mas a Google o descontinuou em 6 de outubro de 2026 na entrada do changelog que apresentou o 2.1, e nenhuma data de encerramento foi anunciada, então ele continua respondendo a solicitações hoje.

Duas configurações na página do modelo explicam seu lugar. Ele suporta apenas raciocínio mínimo e alto, com mínimo como padrão, então uma solicitação padrão pula a maior parte do raciocínio que o 2.1 adiciona em médio; e sua página de modelo ainda cobre um tamanho de saída 512 que o 2.1 não lista. Na nossa rodada de outubro ele produziu as exatas duas linhas de texto do pôster em um caso pareado, e é o ID para o qual a maioria do código existente de imagem do Gemini já aponta.

As falhas aqui são sobre palavras que ele inventa, não palavras que ele perde. Solicitado a criar uma cena de ceramista sem texto algum, ele imprimiu SHIMPO na roda; em um infográfico ele escreveu uma explicação sob cada etapa e errou duas das linhas. Pôsteres também voltaram pendurados em uma parede. Mantenha os prompts longe de props de marca tentadores e leia cada linha adicionada antes de publicar.

Manter um pipeline existente

Se um conjunto de prompts armazenado já produz quadros aceitos neste ID, mantenha-o em execução enquanto a comparação é construída: o modelo está descontinuado mas ainda é servido, e sua saída 512 permanece na página. Reexecute uma amostra fixa desses prompts no gemini-nano-banana-2.1 ao lado dele, então migre quando o ID mais novo vencer nas suas imagens.

Pôsteres planos com texto exato

Seu caso pareado de pôster renderizou ambas as linhas solicitadas sem alteração de ortografia, e nossa execução posterior de infográfico foi o contraexemplo. Escreva o texto como linhas numeradas, proíba slogans e legendas de forma explícita, e verifique o recorte, porque nossos pôsteres chegaram como uma folha pendurada em uma parede e precisaram de corte.

Cenas de produto sem letreiros

Quando uma foto não deve conter texto algum, diga isso e remova props de marca da descrição: nosso quadro de ceramista capturou SHIMPO na roda embora o prompt não pedisse nada escrito. Inspecione rodas, rótulos e embalagens ao fundo em tamanho real, já que letras inventadas se escondem em áreas pequenas.

Notas de teste

No nosso teste de foto de ceramista, o Nano Banana 2 terminou em 28 segundos mas imprimiu o nome da marca “SHIMPO” na roda embora o prompt não pedisse texto.
Ler o teste
No nosso teste de infográfico, o Nano Banana 2 adicionou uma explicação sob cada etapa em uma execução, e duas dessas linhas saíram erradas.
Ler o teste
Ambas as execuções de pôster do Nano Banana 2 voltaram como um mockup pendurado em uma parede cinza em vez de um arquivo plano, então a imagem precisou de corte antes do uso.
Ler o teste
No nosso único caso pareado de pôster, o Nano Banana 2 renderizou corretamente ambas as linhas solicitadas de texto exato sem alteração de ortografia.
Ler o teste
O Nano Banana 2 foi o mais rápido dos três modelos de imagem do Gemini que executamos em 16 de outubro de 2026, com mediana de 24 segundos por imagem 2K.
Ler o teste

Limites a considerar

Texto de marca aparece sem ser convidado: nossa cena de ceramista carregou SHIMPO na roda mesmo com o prompt pedindo nenhum texto.
Explicações são inventadas. Em um infográfico ele adicionou uma linha sob cada etapa e errou duas delas, então proíba legendas ou reserve uma passada de correção.
Pôsteres voltam como um mockup pendurado em uma parede cinza em vez de um arquivo plano, e nossas execuções precisaram de corte antes da imagem ser utilizável.
A Google descontinuou este ID em 6 de outubro de 2026 sem nomear uma data de encerramento, então novos trabalhos pertencem ao Nano Banana 2.1 enquanto o ID antigo continua respondendo.

Comparar modelos próximos

Modelo	Melhor para	Operações	Preço divulgado
Nano Banana 2Esta página gemini-3.1-flash-image	Reproduzir saídas aceitas de um pipeline existente, nas mesmas faixas listadas do 2.1.	Texto para imagem · Edição de imagem	$0,019–$0,039 por chamada
Nano Banana 2.1 gemini-nano-banana-2.1	Novos projetos: letreiros mais limpos, uma faixa de tamanhos sem 512 e um nível padrão de raciocínio mais alto.	Texto para imagem · Edição de imagem	$0,019–$0,039 por chamada
Nano Banana 2 Lite gemini-3.1-flash-lite-image	Rascunhos e miniaturas somente 1K onde um único tamanho fixo cobre todo o trabalho.	Texto para imagem · Edição de imagem	$0,019 por chamada
Nano Banana Pro gemini-3-pro-image	Layouts complexos e edições de retrato que justificam a faixa máxima listada em todos os tamanhos.	Texto para imagem · Edição de imagem	$0,039–$0,069 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.1-flash-image-001" \
  -d '{
    "model": "gemini-3.1-flash-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,019–$0,039por chamadaEconomize 72%

image_size

1K: $0,019por chamada
2K: $0,029por chamada
4K: $0,039por chamada

Mais modelos de imagem Google

Nano Banana 2.1

gemini-nano-banana-2.1

Nano Banana 2 Lite

gemini-3.1-flash-lite-image

Nano Banana

gemini-2.5-flash-image

Perguntas frequentes

Como chamo Nano Banana 2 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 2?

O Nano Banana 2 é cobrado a $0,019–$0,039 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.

O Nano Banana 2 ainda é utilizável após a descontinuação?

Sim. A Google marcou o gemini-3.1-flash-image como descontinuado em seu changelog de 6 de outubro de 2026 sem nomear uma data de encerramento, e ele ainda está listado nas mesmas faixas do Nano Banana 2.1. Trate o aviso como um motivo para planejar uma migração, não como um sinal de que as solicitações falham hoje.

Devo mover este trabalho para o Nano Banana 2.1?

Para novos trabalhos, sim: o 2.1 é o sucessor recomendado, tem raciocínio médio como padrão e cobre de 1K a 4K sem a faixa 512. Se um pipeline estiver estável, execute uma amostra fixa dos seus próprios briefings em ambos os IDs e migre quando o mais novo precisar de menos novas tentativas, não antes.

Por que texto aparece quando eu não pedi nenhum?

O modelo preenche lacunas. Nosso briefing de ceramista dizia nenhum texto e a roda ainda carregou SHIMPO, então diga quais partes da cena devem permanecer em branco, mantenha props de marca fora da descrição, e inspecione o quadro em tamanho real onde letreiros pequenos se escondem.

Ele gasta tokens de raciocínio como o 2.1?

Menos por padrão. Ele suporta apenas raciocínio mínimo e alto, com mínimo como padrão, então uma solicitação não especificada gasta bem menos em raciocínio do que uma solicitação ao 2.1 que começa em médio. Defina o nível explicitamente ao comparar os dois, ou a diferença será lida como qualidade de imagem.

Quais tamanhos de saída estão disponíveis?

1K, 2K e 4K, além da configuração 512 que somente este modelo lista; o 2.1 começa em 1K. Um nome de resolução descreve uma faixa de saída, não um quadro quadrado, então declare a proporção na mesma solicitação e leia as dimensões do arquivo que você recebe.