Documentação e guia de uso do agente **NanoBanana2 KIE** — blueprint…

INEMA

✅ COMO USAR O nano-banana-2.md⌗

🔹 Opção 1 — Usar como base para criar um app (Node.js ou Python)⌗

Você precisa:

1. 🔑 Sua API Key da Kie.ai
2. Criar um pequeno script que:

• Envia o prompt
• Recebe taskId
• Faz polling
• Retorna a URL da imagem

---

🚀 Exemplo Rápido (Node.js)⌗

1️⃣ Instale o axios⌗

npm install axios

---

2️⃣ Crie um arquivo generate.js⌗

```const axios = require("axios");

const API_KEY = process.env.KIE_API_KEY; // ou coloque direto aqui

async function generateImage(prompt) { const createResponse = await axios.post( "api.kie.ai/api/v1/jobs/createTask ↗", { model: "nano-banana-2", input: { prompt: prompt, aspect_ratio: "1:1", resolution: "1K", output_format: "png", google_search: false } }, { headers: { Authorization: Bearer ${API_KEY}, "Content-Type": "application/json" } } );

const taskId = createResponse.data.data.taskId; console.log("Task ID:", taskId);

// Polling while (true) { await new Promise(r => setTimeout(r, 5000));

const poll = await axios.get(
  `https://api.kie.ai/api/v1/jobs/recordInfo?taskId=${taskId}`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);

const state = poll.data.data.state;
console.log("Status:", state);

if (state === "success") {
  const resultJson = JSON.parse(poll.data.data.resultJson);
  console.log("Image URL:", resultJson.resultUrls[0]);
  break;
}

} }

generateImage("A photorealistic cat sitting on a windowsill, golden hour lighting, ultra detailed");```

---

3️⃣ Rode o script⌗

export KIE_API_KEY=SEU_TOKEN_AQUI node generate.js

E ele vai te devolver a URL da imagem.

---

🔥 Opção 2 — Usar via CURL direto no terminal⌗

Criar tarefa⌗

curl -X POST https://api.kie.ai/api/v1/jobs/createTask \ -H "Authorization: Bearer SUA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "nano-banana-2", "input": { "prompt": "A photorealistic cat sitting on a windowsill, golden hour lighting, ultra detailed", "aspect_ratio": "1:1", "resolution": "1K", "output_format": "png", "google_search": false } }'

Depois usar o taskId retornado para fazer polling.

---

🎯 O Papel do Arquivo .md⌗

Ele serve como:

• 📘 Documentação técnica
• 🧠 Guia de engenharia de prompt
• 📡 Referência da API
• 🔄 Modelo de fluxo completo de geração
• ⚠️ Guia de tratamento de erros

---

💡 Em resumo⌗

Você usa ele para:

• Construir seu próprio gerador de imagens
• Criar um SaaS
• Integrar em um app
• Criar um bot
• Automatizar geração de imagens

O arquivo nano-banana-2.md é um guia técnico para construir um agente de geração de imagens usando a API da Kie.ai (modelo nano-banana-2).

🔥 Em resumo, ele faz o seguinte:⌗

1️⃣ Define como autenticar na API⌗

• Usa Bearer Token
• Prioridade: variável de ambiente KIE_API_KEY → chave fornecida pelo usuário → solicitar chave

---

2️⃣ Implementa um “Prompt Enhancement Engine”⌗

Antes de enviar qualquer pedido para gerar imagem, ele:

• Detecta ou define um estilo (ex: fotorealista, anime, 3D, logo, etc.)

• Adiciona:

• Prefixo inteligente

• Sufixos de qualidade
• Tags técnicas (8K, ultra-detailed, sharp focus)
• Ajustes de iluminação, composição e atmosfera
• Garante que o prompt fique mais profissional e detalhado

Ou seja: transforma um prompt simples em um prompt avançado e otimizado.

---

3️⃣ Mostra como criar a tarefa na API⌗

Faz um POST para:

https://api.kie.ai/api/v1/jobs/createTask

Com:

• prompt aprimorado
• proporção (aspect_ratio)
• resolução
• formato PNG

---

4️⃣ Implementa sistema de polling⌗

Após criar a tarefa:

• Consulta o status a cada 5 segundos
• Aguarda até 3 minutos
• Detecta quando terminou
• Extrai a URL final da imagem

---

5️⃣ Trata erros automaticamente⌗

Inclui lógica para:

• 401 (API key inválida)
• 429 (rate limit)
• Falhas de geração
• Timeout
• Ausência de URL

Com estratégia de retry progressiva.

---

6️⃣ Permite geração em lote⌗

Para múltiplas variações:

• Faz várias chamadas separadas
• Polling concorrente
• Entrega todas as imagens juntas

---

🎯 Resumo Final⌗

Esse arquivo é basicamente:

Um blueprint completo para construir um app/agente inteligente que:

• Recebe um prompt
• Melhora ele automaticamente
• Envia para a API da Kie.ai
• Espera a geração
• Retorna a URL final da imagem
• Trata erros de forma robusta

Agente NanoBanana2 KIE

chatgpt.com ↗

1