Google · API de mídia

Nano Banana 2 API

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

Obtenha sua chave API Leia os documentos

IDs de modelo disponíveis: gemini-3.1-flash-imagegemini-3.1-flash-image-previewOs dois IDs chamam o mesmo produto com os mesmos recursos e o mesmo preço. Você pode usar qualquer um deles.
Provedor: Google
Modalidade: Imagem de IA
Por chamada bem-sucedida: $0,068
Última verificação: 2026-09-11

Onde ele se encaixa

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.

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.

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,068por chamada

Mais modelos de imagem Google

Nano Banana 2 Lite

gemini-3.1-flash-lite-image

Nano Banana

gemini-2.5-flash-image

Nano Banana Pro

gemini-3-pro-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,068 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.