API

Nano Banana 2 Lite API

Imagem

A Nano Banana 2 Lite API oferece geração de imagens rápida e eficiente, com consistência confiável de personagens, fusão suave de várias imagens e edição em linguagem natural para fluxos criativos do dia a dia. Integre a Nano Banana 2 Lite API para uma geração visual leve e de alta qualidade.

Autorizações

Bearerstringheaderobrigatório

Chave de API para autorizar solicitações

Corpo

application/json

modelstringobrigatório

nano-banana-2-lite

input.promptstringobrigatório

Descreva a imagem que deseja criar ou as alterações que deseja fazer nas imagens de referência. Espaços em branco excedentes são removidos.

Comprimento máximo: 5.000 caracteres

input.imagesstring[]opcional

URLs opcionais de imagens de referência. Use apenas URLs HTTPS publicamente acessíveis. Omita este campo para gerar imagens a partir de texto.

Máximo de itens: 14

input.aspect_ratiostringopcional

Proporção entre largura e altura da saída. Auto permite que o modelo escolha.

Padrão: auto

auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1

Exemplos de requisição

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2-lite",
  "input": {
    "prompt": "Uma foto de produto cinematográfica de uma câmera futurista em formato de banana"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "nano-banana-2-lite",
    "status": "processing",
    "credits": 18
  }
}

Consulte este endpoint usando o ID da tarefa retornado até que a tarefa seja concluída ou falhe. Recomendamos consultar a cada 5 segundos para verificar o status mais recente.

POST /api/v1/check

{
  "task_id": "task_example"
}

Resposta

Status da tarefa retornado por POST /api/v1/check. Os IDs, URLs e horários abaixo são ilustrativos.

idstringobrigatório

Identificador da tarefa em data.id, igual ao task_id enviado na consulta.

statusstringobrigatório

completed indica que a geração foi bem-sucedida e data.data contém os resultados. Nos demais status, data.data é null.

failed_reasonstringopcional

Retornado somente quando status é failed, para explicar a falha. O campo é omitido em completed e processing.

Concluída · completed

Os URLs de download estão em data.data.results.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "nano-banana-2-lite",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Outros status

Em processing ou failed, data.data é null. Este exemplo mostra failed: somente failed inclui failed_reason. Continue consultando em processing; pare em failed.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "nano-banana-2-lite",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Consumo de créditos

Créditos consumidos por uma solicitação que gera uma imagem.

Créditos consumidos por uma solicitação que gera uma imagem.
Geração	Créditos por solicitação
Uma imagem	18

Envie explicitamente os parâmetros input indicados para usar a tarifa correspondente. Solicitações que geram várias imagens podem consumir mais créditos.

O campo credits retornado por POST /api/v1/create mostra os créditos cobrados pela tarefa.