Referência da API Nano Banana Pro para Desenvolvedores

O serviço Visual Production da API Nano Banana Pro permite que desenvolvedores se conectem a motores avançados de machine learning para criar imagens de alta qualidade a partir de prompts de texto e fotografias de referência. A nossa solução oferece uma interface REST simples com gestão de tarefas e notificações em tempo real.

Todas as requisições à API devem incluir autenticação válida usando token Bearer. Inclua a sua chave API no cabeçalho Authorization em cada pedido.

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

Crie imagens com a Nano Banana Pro API usando machine learning avançado, prompts de texto flexíveis e imagens de referência.

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

Consultar o estado e os resultados das tarefas de geração de imagens da API Nano Banana Pro usando o ID da tarefa retornado pelo endpoint de geração de imagens.

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

Referência completa dos formatos e esquemas de dados da API Nano Banana Pro usados em pedidos e respostas.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}

Guia completo para tratar erros e interpretar códigos de resposta da API. Todas as mensagens de erro usam um formato consistente para permitir uma resolução de problemas eficaz.

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}