Logotipo Nano BananaNano Banana
Introdução à APIInício rápidoNano Banana ProNano Banana 2Nano Banana 2 Lite

Começar

Início rápido

Comece a usar a Nano Banana API com um token Bearer, um corpo de solicitação JSON e os dois endpoints de produção: create e check.

O que você precisa

  • AUma conta Nano Banana com créditos disponíveis
  • Uma chave de API criada no painel de Chaves de API

Obtenha sua chave de API

Faça login, abra a página de Chaves de API, insira um nome para a chave e clique em Criar. Copie a chave imediatamente; a chave completa é exibida apenas uma vez.

Configure o cabeçalho da solicitação HTTP

URL base

HTTPS
https://nanobanana.io
HTTP
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Início rápido

Envie um payload JSON para criar uma tarefa de geração assíncrona. Salve o task_id retornado e use-o para consultar o status da tarefa.

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": "1k"
  }
}'
Resposta
{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

Criar uma tarefa

Envie um ID de modelo e um objeto de entrada para criar uma tarefa de geração assíncrona. Este endpoint confirma que a tarefa entrou na fila; ele não aguarda o resultado final da mídia.

POST/api/v1/create

Autorizações

Campo
Tipo
obrigatório
Descrição e restrições
Authorizationstringobrigatório
Chave de API enviada como token Bearer no cabeçalho da solicitação. Exemplo: Authorization: Bearer sk_live_your_api_key

Corpo da solicitação

application/json
Campo
Tipo
obrigatório
Descrição e restrições
modelstringobrigatório
ID público do modelo. Use um modelo listado na seção da API, por exemplo nano-banana-2.
inputobjectobrigatório
Entrada de geração. Deve incluir um prompt não vazio. Os demais campos de entrada são específicos de cada modelo; consulte a documentação correspondente antes de enviar campos como imagens, proporção, duração, resolução ou quantidade.
JSON
{
  "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": "1k"
  }
}

Resposta de criação

application/json

Uma resposta bem-sucedida retorna o ID da tarefa, o ID do modelo, o status na fila e a quantidade de créditos reservados para essa tarefa.

HTTP 201
{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

Obter status da tarefa

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

Corpo da solicitação

application/json
Campo
Tipo
obrigatório
Descrição e restrições
task_idstringobrigatório
O ID da tarefa retornado por POST /api/v1/create. Use esse ID para obter o status da tarefa e as URLs dos resultados finais.
JSON
{
  "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617"
}

Resposta de status

application/json

Quando o processamento é concluído, a resposta inclui as URLs dos resultados finais e metadados de tempo. Enquanto a tarefa ainda estiver em execução, data é retornado como null.

HTTP 200
{
  "id": "adc0e6ec-9c12-44fc-b45f-112187766c3",
  "created_at": 1788652800,
  "model": "nano-banana-2",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.nanobanana.io/api/predictions/example.mp4"
    ],
    "processing_time": 48
  }
}