API

Nano Banana API

Imagem

Autorizações

Bearerstringheaderobrigatório

Chave de API para autorizar solicitações

Corpo

application/json
modelstringobrigatório
nano-banana
input.promptstringobrigatório

input.imagesstring[]opcional

input.aspect_ratiostringopcional

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",
  "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",
    "status": "processing",
    "credits": 10
  }
}

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",
    "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",
    "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çãoCréditos por solicitação
Uma imagem10

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.