Nano Banana API

Imagem de IA

A API do Nano Banana oferece a rota Gemini 2.5 Flash Image original do Google na OmniaKey, com geração por texto e edição por referência pela API de mídia.

Ler a documentação Obtenha sua chave API

Por chamada bem-sucedida$0,019
OperaçõesTexto para imagem
Edição de imagem
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 oferece a rota Gemini 2.5 Flash Image original do Google na OmniaKey, com geração por texto e edição por referência pela API de mídia.

Use o Nano Banana em fluxos existentes do Gemini 2.5. O Nano Banana 2 tem o mesmo preço em 1K e oferece saídas maiores.

O que ele faz

Texto para imagem

gemini-2.5-flash-image

Transforma um texto em uma nova imagem.

Edição de imagem

gemini-2.5-flash-image

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

Em detalhe

O Nano Banana é o modelo Gemini 2.5 Flash Image original do Google no OmniaKey, listado como gemini-2.5-flash-image com texto para imagem e edição de imagem. Nano Banana é o nome de produto do Google para a geração e edição de imagem nativa do Gemini, e este é o membro mais antigo dessa família aqui: o catálogo informa uma única tarifa por chamada, sem faixas de tamanho e sem alias de preview ao lado.

Seu uso mais útil no nosso próprio trabalho não teve relação com vencer uma comparação. Usamos ele para criar as imagens de origem que outros modelos depois editaram, assim nenhum modelo julgou a própria saída, e um quadro neutro é exatamente o que um modelo legado faz bem. É também o ID que códigos existentes do Gemini 2.5 já chamam.

Dois limites definem a decisão. O catálogo não lista degrau de 2K ou 4K para este ID, então uma entrega grande exige outro modelo; e as melhorias que o Google lançou depois, em renderização de texto, referências e edições de vários turnos, ficam nos IDs mais novos. Mantenha este para continuidade e para material de origem, e comece novos briefings no Nano Banana 2.1 ou no Pro.

Quadros neutros para testes de edição

Quando vários modelos precisam editar a mesma imagem, crie essa imagem aqui. Nossa rodada de seis testes em outubro fez exatamente isso, assim nenhum modelo foi solicitado a melhorar a própria saída e a comparação permaneceu honesta. Mantenha a origem simples, ajuste a luz e a composição uma vez e reutilize o arquivo em todos os lugares.

Código existente do Gemini 2.5

Clientes escritos para a geração 2.5 continuam funcionando sem reescrita: o mesmo formato de tarefa, a mesma operação de edição, uma tarifa por chamada. Fixe o ID na configuração em vez de codificá-lo diretamente, para que uma migração posterior para gemini-nano-banana-2.1 seja uma mudança de configuração mais uma nova execução do seu conjunto de amostras.

Quadros simples de produto e estilo de vida

Briefings simples ainda saem utilizáveis: um objeto, luz do dia, fundo limpo, sem tipografia densa. Evite para pôsteres, colunas de preços ou um grupo de pessoas que precisa permanecer reconhecível, e use um modelo mais novo nessas tarefas em vez de forçar este.

Limites a considerar

O catálogo lista uma única tarifa por chamada e nenhuma faixa de tamanho para este ID, então leia as dimensões entregues em vez de supor uma tela de 2K ou 4K.
É o membro mais antigo da família aqui: o trabalho de texto, referência e vários turnos que o Google lançou depois pertence aos IDs mais novos, não a este.
O Google afirma que imagens geradas carregam uma marca d'água SynthID, que indica procedência e não diz nada sobre se a imagem está correta.
Uma edição recebe a origem embutida em um corpo de 1 MiB, então um arquivo de câmera em tamanho real precisa ser redimensionado antes que a tarefa possa ser criada.

Comparar modelos próximos

Modelo	Melhor para	Operações	Preço divulgado
Nano BananaEsta página gemini-2.5-flash-image	Fluxos de trabalho existentes da 2.5 e quadros de origem neutros, a uma tarifa listada por chamada.	Texto para imagem · Edição de imagem	$0,019 por chamada
Nano Banana 2.1 gemini-nano-banana-2.1	Novo trabalho com letras exatas, dez referências de objeto e saída de 1K a 4K.	Texto para imagem · Edição de imagem	$0,019–$0,039 por chamada
Nano Banana Pro gemini-3-pro-image	Layouts complexos e edições de retrato em que o nível mais alto listado compra detalhe físico.	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-2.5-flash-image-001" \
  -d '{
    "model": "gemini-2.5-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,019por chamadaEconomize 51%

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 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?

O Nano Banana é cobrado a $0,019 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 é o mesmo que o Nano Banana 2?

Não. Nano Banana é o nome de produto do Google para a geração de imagem nativa do Gemini, e este ID, gemini-2.5-flash-image, é o membro mais antigo da família na plataforma. O Nano Banana 2 usa gemini-3.1-flash-image e o Nano Banana 2.1 usa gemini-nano-banana-2.1, cada um um modelo separado com comportamento próprio.

Este modelo consegue produzir uma imagem 4K?

O catálogo não lista degraus de tamanho para este ID, então planeje com base no tamanho que ele retorna em vez de uma tela que você escolhe. Se o objetivo é um arquivo 4K, o Nano Banana 2 e o 2.1 listam de 1K a 4K, e o Pro acrescenta um nível mais alto próprio acima deles.

Como a cobrança é contada neste modelo?

Uma imagem por chamada a uma única tarifa, sem degraus de tamanho para escolher, então repetir o mesmo briefing custa o mesmo a cada vez. A tarifa atual está na tabela de preços da página do modelo. Uma tarefa com falha devolve o crédito reservado, e um link de ativo expirado pode ser atualizado consultando a mesma tarefa novamente.

Por que manter um modelo de imagem mais antigo no conjunto?

Por continuidade e por material de origem: prompts que já passam na revisão continuam funcionando, e um quadro neutro para uma comparação de edição não precisa do modelo mais forte. Novos briefings com tipografia densa, várias referências ou uma tela grande pertencem a um ID mais novo.

Ele adiciona uma marca d'água à imagem?

O Google afirma que imagens geradas incluem uma marca d'água SynthID, e este modelo pertence a essa família. A marca é metadado de procedência, não um logotipo visível, e não diz nada sobre se um rótulo, uma contagem ou um rosto saíram corretos.