Tutorial Completo de Integração do OpenClaw com a API Nano Banana Pro: 3 Passos de Configuração + 5 Habilidades Recomendadas

OpenClaw e Nano Banana Pro: O Agente de IA Open Source Mais Poderoso Encontra a Geração de Imagens de Ponta

OpenClaw é a plataforma de agente de IA open source mais popular no GitHub atualmente (mais de 250 mil estrelas), e Nano Banana Pro é o modelo de geração de imagens de ponta lançado pelo Google DeepMind. A combinação dos dois significa que você pode chamar a capacidade de geração de imagens de nível Studio a qualquer momento em mais de 12 plataformas como WhatsApp, Telegram, Slack, etc. — e através da APIYI, o NB Pro de 1K a 4K tem o mesmo preço de apenas $0.05/chamada, o que equivale a 20% do preço oficial.

Valor Central: Ao ler este artigo, você concluirá a configuração de integração do OpenClaw + NB Pro, dominará o método de chamada de código e conhecerá 5 Habilidades do OpenClaw que podem aumentar significativamente a eficiência da geração de imagens.

Visão Geral da Plataforma OpenClaw: Por Que Escolher Para Integrar o Nano Banana Pro

Antes de configurar, vamos entender rapidamente as capacidades principais do OpenClaw e por que ele é a plataforma ideal para integrar o NB Pro.

Resumo das Informações Principais do OpenClaw

O diferencial do OpenClaw é o mecanismo "Heartbeat" — a IA pode se autoativar através de tarefas Cron e Webhook, sem precisar que você envie uma mensagem para disparar. Isso significa que você pode definir fluxos de trabalho automatizados como "gerar material de marketing diário automaticamente às 9h da manhã", combinando com a capacidade de geração de imagens do NB Pro, para realmente alcançar a criação de IA sem supervisão.

🚀 Experimente Rapidamente: Se você ainda não instalou o OpenClaw, pode experimentar o efeito de geração de imagens do NB Pro online em imagen.apiyi.com antes de decidir integrá-lo. A APIYI oferece um limite de teste gratuito, permitindo gerar imagens sem necessidade de configuração.

Instalação do OpenClaw

# macOS / Linux
curl -fsSL https://get.openclaw.ai | bash

# Ou use npm
npm install -g @openclaw/openclaw

Após a instalação, execute o comando openclaw para iniciar o assistente de configuração.

OpenClaw com APIYI Nano Banana Pro: Configuração em 3 Passos

A ideia principal para integrar é simples: registrar APIYI como um provedor de modelo personalizado no OpenClaw e, em seguida, configurar o modelo Nano Banana Pro. APIYI é totalmente compatível com o formato da API oficial do Google, bastando substituir o endereço de solicitação e a chave API.

Passo 1: Obter Chave APIYI

1. Acesse o site oficial do APIYI em apiyi.com e registre uma conta.
2. Vá para o console e crie uma nova Chave API.
3. Na lista de modelos, confirme se o Nano Banana Pro (gemini-3-pro-image-preview) está ativado.

Passo 2: Editar Arquivo de Configuração do OpenClaw

Abra o arquivo de configuração do OpenClaw ~/.openclaw/openclaw.json e adicione APIYI como um provedor personalizado:

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sua-chave-apiyi",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3-pro-image-preview",
            "name": "Nano Banana Pro"
          },
          {
            "id": "gemini-3.1-flash-image-preview",
            "name": "Nano Banana 2"
          }
        ]
      }
    }
  }
}

Passo 3: Definir Modelo Padrão de Geração de Imagem

No mesmo arquivo de configuração, especifique o NB Pro como o modelo padrão de geração de imagem:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gemini-3-pro-image-preview"
      }
    }
  }
}

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gemini-3-pro-image-preview"
      }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-sua-chave-apiyi-aqui",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3-pro-image-preview",
            "name": "Nano Banana Pro",
            "contextWindow": 65536,
            "cost": {
              "input": 0.25,
              "output": 60.0
            }
          },
          {
            "id": "gemini-3.1-flash-image-preview",
            "name": "Nano Banana 2",
            "contextWindow": 131072,
            "cost": {
              "input": 0.125,
              "output": 30.0
            }
          }
        ]
      }
    }
  }
}

Após a configuração, reinicie o OpenClaw para que as alterações entrem em vigor.

Pontos Chave da Configuração do OpenClaw com NB Pro

💡 Nota Importante: O campo api deve ser definido como google-generative-ai e não openai-completions. O NB Pro usa o endpoint nativo generateContent do Google, e APIYI é totalmente compatível com este formato. Se você usar o modo compatível com OpenAI, a funcionalidade de geração de imagem não funcionará corretamente.

Chamada de Código da API Nano Banana Pro: Uso Direto do Formato Oficial

APIYI é totalmente compatível com o formato de chamada da documentação oficial do Google. Se você já está usando a API oficial do Google, precisa apenas fazer duas modificações:

1. Substituir o endereço de solicitação: Mude generativelanguage.googleapis.com para api.apiyi.com.
2. Substituir a Chave API: Use a chave fornecida pelo APIYI.

Exemplo de Chamada de Código Nano Banana Pro (Python)

import google.generativeai as genai

# Configurar o endpoint APIYI — basta substituir o endereço e a chave
genai.configure(
    api_key="sua-chave-apiyi",
    client_options={"api_endpoint": "api.apiyi.com"}
)

model = genai.GenerativeModel("gemini-3-pro-image-preview")

response = model.generate_content(
    "Um gato laranja sentado no parapeito da janela observando a chuva, estilo anime japonês, iluminação interna acolhedora",
    generation_config=genai.GenerationConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config={"image_size": "2K", "aspect_ratio": "16:9"}
    )
)

# Extrair a imagem gerada
for part in response.candidates[0].content.parts:
    if hasattr(part, "inline_data"):
        with open("output.png", "wb") as f:
            f.write(part.inline_data.data)
        print("Imagem salva como: output.png")
    elif hasattr(part, "text"):
        print(f"Descrição: {part.text}")

curl -X POST "https://api.apiyi.com/v1/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: sua-chave-apiyi" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Gere uma imagem de uma cidade cyberpunk à noite, com luzes de neon refletindo nas ruas molhadas"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "imageSize": "4K",
        "aspectRatio": "21:9"
      }
    }
  }'

const { GoogleGenerativeAI } = require("@google/generative-ai");
const fs = require("fs");

// Configurar o endpoint APIYI
const genAI = new GoogleGenerativeAI("sua-chave-apiyi", {
  baseUrl: "https://api.apiyi.com/v1"
});

const model = genAI.getGenerativeModel({
  model: "gemini-3-pro-image-preview"
});

async function generateImage() {
  const result = await model.generateContent({
    contents: [{
      role: "user",
      parts: [{ text: "Uma pintura a tinta chinesa de paisagem montanhosa, montanhas distantes e água próxima, com um senso de espaço em branco" }]
    }],
    generationConfig: {
      responseModalities: ["TEXT", "IMAGE"],
      imageConfig: { imageSize: "4K", aspectRatio: "3:2" }
    }
  });

  const response = result.response;
  for (const part of response.candidates[0].content.parts) {
    if (part.inlineData) {
      const imageBuffer = Buffer.from(part.inlineData.data, "base64");
      fs.writeFileSync("output.png", imageBuffer);
      console.log("Imagem salva como: output.png");
    }
  }
}

generateImage();

Descrição dos Parâmetros de Resolução Completa do Nano Banana Pro

🎯 Vantagem de Custo: O NB Pro na APIYI tem um preço fixo de $0.05 por chamada para todas as resoluções de 1K a 4K. Isso significa que o custo para gerar uma imagem ultra-alta definição 4K (4096×4096) é o mesmo que para 1K. Basta escolher 4K para obter a melhor qualidade de imagem.

Teste e Validação de Geração de Imagens com OpenClaw Nano Banana Pro

Após a configuração, você pode enviar mensagens diretamente no OpenClaw para testar o efeito de geração de imagens.

Testando no OpenClaw

Envie diretamente em qualquer plataforma de mensagens conectada (Telegram, WhatsApp, etc.):

Gere uma imagem para mim: um cachorro Shiba Inu usando óculos escuros surfando em uma praia, com sol brilhante, estilo cartoon

O OpenClaw chamará automaticamente o modelo NB Pro configurado, gerará a imagem e a responderá na conversa.

Teste de Geração de Imagens Online

Se você quiser testar a qualidade da geração de imagens do NB Pro antes de configurar o OpenClaw, pode usar a ferramenta de teste online fornecida pela APIYI:

• Endereço de teste de geração de imagens: imagen.apiyi.com
• Não é necessário escrever código, basta inserir o comando online para gerar a imagem.
• Suporta todos os parâmetros de resolução e proporção.
• Ideal para verificar rapidamente o efeito dos comandos.

Download de Exemplos de Código

A APIYI fornece um pacote completo de código de referência de desenvolvimento, incluindo exemplos de chamadas em várias linguagens como Python, Node.js, cURL, etc.:

• Download de exemplos de código: xinqikeji.feishu.cn/wiki/W4vEwdiCPi3VfTkrL5hcVlDxnQf
• Documentação oficial do Google: ai.google.dev/gemini-api/docs/image-generation

💰 Sugestão de controle de custos: Para a fase de desenvolvimento e teste, recomendamos o uso do NB2 ($0.035/chamada) para economizar custos. Após o lançamento oficial, mude para o NB Pro ($0.05/chamada) para obter a melhor qualidade de imagem. Na plataforma APIYI, os dois modelos exigem apenas a modificação do ID do modelo, sem a necessidade de alterar outro código.

OpenClaw Skills Recomendados: 5 Habilidades para Aumentar a Eficiência de Geração de Imagens do Nano Banana Pro

O poder do OpenClaw reside em seu ecossistema de habilidades. No ClawHub, existem mais de 5.490 habilidades da comunidade, e as 5 seguintes são as mais relevantes para geração de imagens:

Habilidade 1: Image Generator (Assistente de Geração de Imagens)

O valor principal desta habilidade é a otimização de comandos. Você só precisa dizer "Desenhe um gato para mim", e ele será expandido automaticamente em comandos profissionais que incluem detalhes de estilo, iluminação e composição, melhorando significativamente a qualidade das imagens geradas pelo NB Pro.

Habilidade 2: Batch Image Creator (Criador de Imagens em Lote)

Ideal para cenários que exigem a geração de várias imagens de uma vez, como imagens de produtos para e-commerce, calendários de conteúdo semanal para mídias sociais, etc. Esta habilidade pode:

• Gerar em lote várias imagens com diferentes ângulos/estilos com base em um tema.
• Gerenciar automaticamente a fila de geração para evitar limites de taxa.
• Suportar comandos baseados em modelos, substituindo variáveis-chave para gerar imagens em lote.

Habilidade 3: Image Editor (Editor de Imagens)

O NB Pro não só gera imagens, mas também suporta edição baseada em imagens de referência. Esta habilidade encapsula o fluxo de trabalho de edição de imagens:

• Carregue a imagem original + solicitação de modificação por descrição de texto.
• Suporta modificação local (trocar fundo, alterar cor, adicionar elementos).
• Processa automaticamente a conversão de formato de imagem e codificação Base64.

Habilidade 4: Social Media Poster (Postador de Mídias Sociais)

Uma habilidade de geração de imagens projetada especificamente para mídias sociais:

• Modelos de tamanho otimizados integrados para plataformas como Instagram, Twitter, Xiaohongshu, etc.
• Gera automaticamente pôsteres com texto (utilizando a excelente capacidade de renderização de texto do NB Pro).
• Suporta configurações de consistência de cores e estilo da marca.

Habilidade 5: Heartbeat Image Scheduler (Agendador de Imagens por Pulso)

Utiliza o exclusivo mecanismo Heartbeat do OpenClaw para realizar a geração automática de imagens agendada:

• Defina expressões Cron para acionar a geração de imagens em horários específicos.
• Por exemplo, "gerar uma imagem de 'bom dia' todos os dias às 8:00".
• As imagens geradas são enviadas automaticamente para a plataforma de mensagens especificada.
• Ideal para equipes de operações automatizarem a produção de conteúdo.

Método de Instalação das Habilidades

Instalar habilidades no OpenClaw é muito simples:

# Instalar via ClawHub
openclaw skill install image-generator

# Ou peça à IA para instalar diretamente na mensagem
# Envie: "Instalar a habilidade image-generator"

Você também pode navegar pelo catálogo completo de habilidades no site do ClawHub: clawhub.openclaw.ai

🎯 Melhor Prática: Recomendamos instalar primeiro a habilidade Image Generator, pois ela pode otimizar automaticamente seus comandos, melhorando significativamente a qualidade das imagens geradas pelo NB Pro. Combinado com a vantagem de baixo custo da APIYI apiyi.com, você pode iterar várias vezes com confiança e encontrar rapidamente os resultados mais satisfatórios.

Nano Banana Pro vs NB2: Como Escolher no OpenClaw

A APIYI suporta os modelos NB Pro e NB2, ambos já adicionados na configuração do OpenClaw. Escolha o modelo apropriado com base em diferentes cenários:

No OpenClaw, alternar modelos requer apenas a modificação do comando de mensagem:

# Gerar imagem com NB Pro (padrão)
Use NB Pro para me gerar uma imagem promocional de produto

# Mudar para NB2 para geração rápida
Use NB2 para gerar rapidamente 5 propostas de logo em estilos diferentes

Ou alterne o modelo padrão temporariamente no arquivo de configuração:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiyi/gemini-3.1-flash-image-preview"
      }
    }
  }
}

Perguntas Frequentes

Resumo: Pontos Essenciais para Integrar OpenClaw com Nano Banana Pro

Passos essenciais para integrar o OpenClaw com o Nano Banana Pro:

1. Obter Chave API: Registre-se na APIYI apiyi.com e obtenha sua Chave API.
2. Editar Configuração: Adicione o provedor APIYI em ~/.openclaw/openclaw.json, definindo api como google-generative-ai.
3. Selecionar Modelo: NB Pro ($0.05/chamada, máxima qualidade) ou NB2 ($0.035/chamada, prioridade na velocidade).
4. Instalar Skills: Instale habilidades como Gerador de Imagens via ClawHub para aumentar a eficiência.
5. Começar a Gerar Imagens: Envie descrições em linguagem natural em qualquer plataforma de mensagens para gerar imagens.

O Nano Banana Pro é o principal modelo com o maior consumo diário na APIYI, e a plataforma investiu muitos recursos de operação e manutenção para garantir sua estabilidade — garantindo encaminhamento oficial, sem limite de velocidade e uso comercial. O preço unificado para todas as resoluções de 1K a 4K é de $0.05/chamada, enquanto o serviço equivalente no site oficial custa $0.234/chamada, apenas cerca de 20% do preço.

Recomenda-se o acesso ao Nano Banana Pro através da APIYI apiyi.com, combinado com o ecossistema de Skills do OpenClaw, para construir um fluxo de trabalho eficiente de geração de imagens por IA.

Suporte Técnico: APIYI apiyi.com — Plataforma de encaminhamento de API de Modelos de Linguagem Grandes de IA estável e confiável, com a série completa NB Pro a partir de 20% do preço.