API

Nano Banana 2 API

Imagem

A Nano Banana 2 API combina conhecimento do mundo em tempo real com raciocínio avançado para oferecer melhor compreensão de prompts e resultados visuais mais precisos. Gere imagens consistentes com múltiplos sujeitos em 4K nativo, use proporções flexíveis e crie tipografia global refinada em composições complexas. Integre a Nano Banana 2 API para criar fluxos de imagem mais inteligentes, escaláveis e de alta qualidade.

Autorizações

Bearerstringheaderobrigatório

Chave de API para autorizar solicitações

Corpo

application/json

modelstringobrigatório

nano-banana-2

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

input.resolutionstringopcional

Nível de resolução da saída; os valores não diferenciam maiúsculas de minúsculas. Omita ou deixe vazio para usar o padrão.

Padrão: 2k

1k2k4k

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",
  "input": {
    "prompt": "Uma foto de produto cinematográfica de uma câmera futurista em formato de banana",
    "aspect_ratio": "1:1",
    "resolution": "2k"
  }
}'

POST /api/v1/create · HTTP 201

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

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",
    "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",
    "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.
Resolução	1K	2K	4K
Uma imagem	20	30	40

Sem parâmetros opcionais: 20 créditos

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.