Google

Nano Banana 2

nano-banana-2

Modelo de imagem rápido do Google para geração de imagens em escala, com suporte de 512px até 4K nativo e diversos formatos, gera com base em informações em tempo real da busca, ideal para criação de alta frequência

nano-banana-2

Experimentar nano-banana-2

Entrada

Criações

Ver todas as criações

Saída

image

Preencha os parâmetros e gere — os resultados aparecerão aqui.

Preços

nano-banana-2 per image

Especificações	Preço unitário
1K	$0.036
2K	$0.057
4K	$0.086

Visão geral

nano-banana-2 é um modelo de geração de imagens lançado pelo Google, que suporta tanto geração de imagem a partir de texto quanto edição com base em imagens de referência. Ele permite que desenvolvedores usem um prompt de até 20000 caracteres, combinado com no máximo 14 imagens de referência, para gerar uma imagem no formato e resolução selecionados em uma única chamada. É indicado para equipes que precisam produzir materiais de marketing em lote, iterar rapidamente rascunhos criativos ou manter consistência de estilo com base em imagens de referência, podendo ser chamado pela interface unificada do HiAPI.ai.

Destaques principais

Até 14 imagens de referência por chamada — o fluxo de imagem para imagem permite enviar até 14 imagens de referência de uma vez, usando múltiplas imagens para restringir personagens, estilos ou layouts, reduzindo o custo de combinação de gerações em lotes.
Saída direta em três níveis de resolução — é possível escolher a resolução de saída entre 1K, 2K e 4K, sem necessidade de uma etapa extra de super-resolução para imagens de alta resolução.
15 orientações de formato — de 1:1 quadrado a 8:1 ultrawide e 9:16 vertical, todas podem ser especificadas diretamente nos parâmetros, ou delegadas ao modo auto adaptativo.

Descrição das capacidades

Geração a partir de texto e edição com imagens de referência: o prompt é a entrada principal, com opção de anexar imagens de referência para transformação ou reaproveitamento de estilo; a mesma interface cobre tanto a geração do zero quanto a reescrita baseada em materiais existentes.

Controle parametrizado das especificações de saída: resolução, proporção e formato de saída são declarados explicitamente nos parâmetros da requisição, retornando jpg ou png, o que facilita a integração direta ao pipeline de materiais downstream.

Capacidade para prompts longos: o campo prompt tem limite de 20000 caracteres, podendo conter descrições de cena, restrições de estilo e instruções de composição mais completas, sem necessidade de grandes cortes por causa do comprimento.

Integração via interface unificada: obtenha resultados de imagem pelo modo de chamada unificado do HiAPI.ai, sem que desenvolvedores precisem manter lógicas de integração upstream separadas para cada capacidade de imagem.

Cenários de aplicação

Produção em lote de imagens para equipes de marketing — gerar em lote imagens promocionais nos tamanhos de cada plataforma a partir de prompts de texto, produzindo imagens em 1:1, 16:9 e 9:16 para uso direto em redes sociais e materiais de anúncios.
Exploração de consistência de estilo com múltiplas imagens por designers — enviar várias imagens de referência para restringir personagens ou estilo visual, produzindo séries de imagens com estilo unificado para comparação de conceitos e iteração de propostas.
Geração em 4K para materiais impressos e de exibição — gerar imagens em resolução 4K e formato especificado, para materiais como pôsteres e painéis expositivos que exigem clareza e proporção bem definidas.

Limitações e recomendações de seleção

Os limites de capacidade seguem os parâmetros atuais: cada chamada gera apenas uma imagem, não oferecendo controles de quantidade em lote, duração de geração ou itens do tipo vídeo, nem parâmetros reproduzíveis como seed; o prompt é obrigatório, não sendo possível gerar sem ele. As imagens de referência são enviadas por URL e limitadas a 14. Se a tarefa exigir edição rigorosa em nível de pixel, controle aleatório reproduzível ou produção em lote de múltiplas imagens, recomenda-se validar o efeito em uma pequena amostra antes de decidir incluí-lo no fluxo de produção.

Perguntas frequentes

Ver todas as perguntas →

Para que tarefas o Nano Banana 2 é principalmente adequado?

Suporta imagens de referência opcionais, proporções variadas e resolução mais alta, podendo ser usado para geração e redesenho de imagens.
O Nano Banana 2 é compatível com imagens de referência?

Suporta até 14 imagens de referência opcionais; se nenhuma for enviada, pode ser usado como geração puramente a partir de texto.
Quais especificações de saída são suportadas?

A página atual exibe 1K, 2K, 4K e 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9, auto; as opções finais estão sujeitas aos parâmetros do Playground.
Como é cobrado o Nano Banana 2?

A cobrança é feita pelo número de imagens geradas com sucesso; eventuais diferenças conforme a resolução ou o nível de qualidade são exibidas no preço em tempo real na página.

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: nano-banana-2

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para nano-banana-2 e a rota default — veja a tabela de parâmetros abaixo.

promptstringObrigatóriomaxLength 20000

Prompt de texto que descreve a imagem a ser gerada, fornecendo a base de conteúdo para a geração da imagem.

resolutionstringOpcionalPadrão: "1K"

Controla a resolução da imagem gerada, em formato de string, padrão 1K.

Opções:1K2K4K

image_inputarrayOpcionalmaxItems 14

Array opcional de URLs de imagens de entrada, usado para transformação de imagem ou como imagem de referência, com suporte a no máximo 14 imagens.

Array [ string ]

aspect_ratiostringOpcionalPadrão: "auto"

Controla a proporção largura-altura da imagem gerada, em formato de string, padrão auto.

Opções:1:11:41:82:33:23:44:14:3

Mostrar tudo (7)

4:55:48:19:1616:921:9auto

output_formatstringOpcionalPadrão: "png"

Controla o formato da imagem de saída, em formato de string, padrão png.

Opções:jpgpng

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "input": {
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "auto",
    "output_format": "png"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "nano-banana-2",
    input: {
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "auto",
      "output_format": "png"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "nano-banana-2",
        "input": {
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "auto",
          "output_format": "png"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}