Google

Nano Banana 2 Lite

Nano-Banana-2-Lite

Modelo leve e eficiente da família Google de imagens, focado em baixa latência e baixo custo, ideal para ideação rápida e geração de imagens em alta escala, com substituição transparente do Nano Banana de primeira geração

Nano-Banana-2-Lite

Experimentar Nano-Banana-2-Lite

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-Lite per image

Preço unitário	$0.033

Visão geral do posicionamento

O Nano-Banana-2-Lite é o modelo leve e focado em eficiência da série de geração de imagens do Google, com suporte tanto para geração de imagem a partir de texto quanto para edição de imagens baseada em imagens de referência. Ele prioriza velocidade de resposta e custo de chamada, sendo adequado para desenvolvedores que precisam gerar imagens em lote e iterar rapidamente em rascunhos iniciais; mantém desempenho utilizável em seguimento de instruções e consistência de personagens, podendo atender desde esboços conceituais até imagens de marketing em múltiplos tamanhos, com refinamento posterior conforme necessário.

Destaques principais

Geração de imagem a partir de texto e edição de imagens na mesma interface — a mesma rota permite gerar imagens diretamente com prompts ou receber até 10 imagens de referência para edição e remixagem, reduzindo trocas de fluxo.
Posicionamento de eficiência para chamadas de alta frequência — dentro da série, é a faixa que prioriza velocidade e custo, adequada para tarefas sensíveis a throughput, como materiais em lote e geração de imagens baseada em modelos.
Saída em 14 proporções de aspecto — é possível especificar diretamente desde 1:1 e 16:9 até proporções extremas como 1:8 e 8:1, gerando de uma vez imagens adaptadas a posicionamentos em múltiplas plataformas.
Suporte a iterações locais em múltiplas rodadas — permite modificar repetidamente partes de um resultado existente, levando o rascunho inicial rapidamente a um estado utilizável.

Descrição das capacidades

Geração de imagem a partir de texto e edição com imagens de referência: enviar apenas o prompt caracteriza geração a partir de texto; incluir de 1 a 10 URLs de imagens de referência converte a operação em edição ou remixagem. A mesma interface cobre os dois tipos de necessidade, facilitando o encapsulamento unificado em um único pipeline.

Saída com proporção de aspecto controlável: aspect_ratio oferece 14 valores e também suporta seleção automática com auto. Desenvolvedores podem fixar diretamente a proporção conforme o posicionamento de veiculação, eliminando recortes e adaptações secundárias posteriores.

Entrada de prompts longos: o prompt pode ter até 20000 caracteres, comportando descrições mais completas de sujeito, composição e estilo, adequado para construir solicitações de geração em lote por meio de combinação de modelos.

Entrada de múltiplas imagens de referência: até 10 imagens de referência em JPEG, PNG ou WebP (cada uma com no máximo 30MB), utilizáveis em tarefas de edição que exigem contexto de múltiplas imagens, como transferência de estilo e combinação de materiais.

Cenários de aplicação

Geração em lote de esboços conceituais por equipes criativas — gerar esboços de propostas em lote com prompts curtos, como material para avaliação interna e triagem de direções, decidindo o investimento em refinamento somente após definir a direção.
Construção de pipelines de geração de imagens de alto throughput por desenvolvedores — gerar em lote imagens de produtos ou conteúdo com prompts baseados em modelos, armazenando-as diretamente para uso sob demanda por sistemas de negócio.
Imagens para múltiplos posicionamentos de marketing e redes sociais — especificar proporções como 1:1, 9:16 e 16:9 conforme o posicionamento de veiculação, gerando de uma vez imagens finais em vários tamanhos e reduzindo retrabalho de recorte posterior.
Modificações locais em múltiplas rodadas de imagens existentes — enviar imagens de referência e descrever alterações com prompts, ajustando detalhes locais rodada a rodada para produzir versões iteradas entregáveis.
Conteúdo seriado com consistência de personagens entre imagens — usar a mesma imagem de referência para manter personagens e identidade visual, produzindo em lote conjuntos de ilustrações ou storyboards com aparência visual unificada.

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

Como modelo leve com prioridade em eficiência, o rascunho inicial de renderização de texto em frases longas ou layouts complexos pode exigir ajustes manuais; instruções de texto simples e claras são mais confiáveis. Para layouts complexos e detalhes de alta precisão, recomenda-se reservar etapas de retrabalho. Atualmente não se dispõe de especificações concretas como limite máximo de resolução, concorrência e cota; é necessário validar por conta própria antes da integração. Se a tarefa exigir qualidade de imagem e compreensão de instruções complexas acima do throughput, deve-se escolher um modelo superior da mesma série; se for apenas para esboços em lote e iteração rápida, este modelo é mais adequado.

Perguntas frequentes

Ver todas as perguntas →

Para que tarefas o Nano Banana 2 Lite é principalmente indicado?

Linha de entrada com 1K fixo, adequada para esboços em grande volume, iterações rápidas e redesenho opcional com múltiplas imagens de referência.
O Nano Banana 2 Lite suporta imagens de referência?

Suporta até 10 imagens de referência opcionais; quando nenhuma é enviada, pode ser usado como geração puramente texto-para-imagem.
Quais especificações de saída são suportadas?

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

A cobrança é feita com base na quantidade de imagens geradas com sucesso; eventuais diferenças entre resoluções ou níveis 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-Lite

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

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

promptstringObrigatóriominLength 1maxLength 20000

Prompt de texto para geração de imagem, em formato de string, com no máximo 20000 caracteres, usado para descrever o conteúdo visual que se deseja gerar ou editar.

image_urlsarrayOpcionalminItems 1maxItems 10

Array opcional de URLs de imagens de referência, cujos elementos são strings de endereços de imagem, usadas para edição de imagem ou composição mista; no máximo 10 imagens, cada uma suportando JPEG/PNG/WebP e não excedendo 30MB; se não for enviado, recai para geração puramente a partir de texto.

Array [ string ]

aspect_ratiostringObrigatórioPadrão: "auto"

Proporção largura-altura da imagem de saída, em formato de string, com padrão auto para o modelo escolher por conta própria.

Opções:auto1:12:33:23:44:34:55:4

Mostrar tudo (7)

9:1616:921:91:44:11:88:1

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-Lite",
  "input": {
    "prompt": "…",
    "aspect_ratio": "auto"
  }
}'

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-Lite",
    input: {
      "prompt": "…",
      "aspect_ratio": "auto"
    }
  }),
});
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-Lite",
        "input": {
          "prompt": "…",
          "aspect_ratio": "auto"
        }
    },
)
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"
    }
  }
}