Tutorial completo de OpenClaw para integrar la API de Nano Banana Pro: 3 pasos de configuración + 5 Skills recomendadas

OpenClaw se integra con Nano Banana Pro: el agente de IA de código abierto más potente se une a la generación de imágenes más potente

OpenClaw es la plataforma de agentes de IA de código abierto más popular en GitHub actualmente (más de 250.000 estrellas), y Nano Banana Pro es el modelo insignia de generación de imágenes de Google DeepMind. La combinación de ambos significa que puedes invocar capacidades de generación de imágenes de nivel de estudio en más de 12 plataformas como WhatsApp, Telegram, Slack, etc., en cualquier momento. Y a través de APIYI, NB Pro 1K a 4K a la misma resolución cuesta solo $0.05/vez, lo que equivale a un 20% del precio oficial.

Valor central: Al leer este artículo, completarás la configuración de integración de OpenClaw + NB Pro, dominarás los métodos de invocación de código y conocerás 5 habilidades de OpenClaw que pueden mejorar significativamente la eficiencia de generación de imágenes.

Introducción a la plataforma OpenClaw: ¿Por qué elegirla para integrar Nano Banana Pro?

Antes de la configuración, echemos un vistazo rápido a las capacidades principales de OpenClaw y por qué es la plataforma ideal para integrar NB Pro.

Información clave de OpenClaw de un vistazo

Lo que hace único a OpenClaw es su mecanismo "Heartbeat": la IA puede activarse a sí misma a través de tareas Cron y Webhooks, sin necesidad de que tú envíes un mensaje para activarla. Esto significa que puedes configurar flujos de trabajo automatizados como "generar materiales de marketing diarios automáticamente a las 9 AM", combinados con la capacidad de generación de imágenes de NB Pro, para lograr verdaderamente la creación de IA sin supervisión.

🚀 Prueba rápida: Si aún no has instalado OpenClaw, puedes probar primero los resultados de generación de imágenes de NB Pro en imagen.apiyi.com antes de decidir si lo integras. APIYI ofrece cuotas de prueba gratuitas, puedes generar imágenes sin necesidad de configuración.

Instalación de OpenClaw

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

# O usa npm
npm install -g @openclaw/openclaw

Después de la instalación, ejecuta el comando openclaw para iniciar el asistente de configuración.

OpenClaw con Nano Banana Pro API: Configuración en 3 pasos

La idea principal para integrar esto es bastante sencilla: registras APIYI en OpenClaw como un proveedor de modelos personalizado y luego configuras el modelo Nano Banana Pro. APIYI es totalmente compatible con el formato de API oficial de Google, así que solo necesitas cambiar la URL de la solicitud y la clave API.

Paso 1: Obtener la clave API de APIYI

1. Visita el sitio web oficial de APIYI en apiyi.com y regístrate.
2. Ve a la consola y crea una nueva API Key.
3. Confirma que Nano Banana Pro (gemini-3-pro-image-preview) está activado en la lista de modelos.

Paso 2: Editar el archivo de configuración de OpenClaw

Abre el archivo de configuración de OpenClaw ~/.openclaw/openclaw.json y añade APIYI como proveedor personalizado:

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "tu-clave-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"
          }
        ]
      }
    }
  }
}

Paso 3: Establecer el modelo de generación de imágenes predeterminado

En el mismo archivo de configuración, especifica NB Pro como el modelo de generación de imágenes predeterminado:

{
  "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-tu-clave-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
            }
          }
        ]
      }
    }
  }
}

Una vez configurado, reinicia OpenClaw para que los cambios surtan efecto.

Puntos clave de la configuración de OpenClaw con NB Pro

💡 Nota importante: El campo api debe configurarse como google-generative-ai y no como openai-completions. NB Pro utiliza el endpoint nativo de Google generateContent, y APIYI es totalmente compatible con este formato. Si utilizas el modo compatible con OpenAI, la función de generación de imágenes no funcionará correctamente.

Llamada a la API de Nano Banana Pro: Uso directo del formato oficial

APIYI es totalmente compatible con el formato de llamada de la documentación oficial de Google. Si ya estás utilizando la API oficial de Google, solo necesitas hacer dos modificaciones:

1. Reemplazar la URL de solicitud: Cambia generativelanguage.googleapis.com por api.apiyi.com.
2. Reemplazar la API Key: Utiliza la clave proporcionada por APIYI.

Ejemplo de llamada a la API de Nano Banana Pro (Python)

import google.generativeai as genai

# Configurar el endpoint de APIYI — solo necesitas cambiar la dirección y la clave API
genai.configure(
    api_key="tu-clave-apiyi",
    client_options={"api_endpoint": "api.apiyi.com"}
)

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

response = model.generate_content(
    "Un gato atigrado naranja sentado en el alféizar de una ventana mirando la lluvia, estilo anime japonés, cálida luz interior",
    generation_config=genai.GenerationConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config={"image_size": "2K", "aspect_ratio": "16:9"}
    )
)

# Extraer la imagen generada
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("Imagen guardada en: output.png")
    elif hasattr(part, "text"):
        print(f"Descripción: {part.text}")

curl -X POST "https://api.apiyi.com/v1/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: tu-clave-apiyi" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Genera una imagen de una ciudad nocturna estilo cyberpunk, con luces de neón reflejándose en calles mojadas"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "imageSize": "4K",
        "aspectRatio": "21:9"
      }
    }
  }'

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

// Configurar el endpoint de APIYI
const genAI = new GoogleGenerativeAI("tu-clave-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: "Una pintura de paisaje de montañas y agua al estilo de tinta china, con montañas distantes y agua cercana, dejando espacio para la contemplación" }]
    }],
    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("Imagen guardada en: output.png");
    }
  }
}

generateImage();

Parámetros de resolución completa de Nano Banana Pro

🎯 Ventaja de coste: NB Pro en APIYI tiene un precio fijo de $0.05 por llamada para todas las resoluciones de 1K a 4K. Esto significa que generar una imagen ultra HD de 4K (4096×4096) cuesta lo mismo que una de 1K. Simplemente elige 4K para obtener la mejor calidad de imagen.

Pruebas y validación de generación de imágenes de OpenClaw Nano Banana Pro

Una vez configurado, puedes enviar mensajes directamente en OpenClaw para probar el efecto de generación de imágenes.

Prueba en OpenClaw

Envía directamente en cualquier plataforma de mensajería conectada (Telegram, WhatsApp, etc.):

Ayúdame a generar una imagen: un Shiba Inu con gafas de sol surfeando en una playa, con sol brillante, estilo de dibujos animados

OpenClaw llamará automáticamente al modelo NB Pro configurado, generará la imagen y la responderá en la conversación.

Prueba de generación de imágenes en línea

Si deseas probar la calidad de generación de imágenes de NB Pro antes de configurar OpenClaw, puedes usar la herramienta de prueba en línea proporcionada por APIYI:

• Dirección de prueba de generación de imágenes: imagen.apiyi.com
• No necesitas escribir código, solo ingresa el prompt en línea para generar la imagen.
• Admite todos los parámetros de resolución y relación de aspecto.
• Adecuado para verificar rápidamente el efecto del prompt.

Descarga de ejemplos de código

APIYI proporciona un paquete completo de código de referencia de desarrollo, que incluye ejemplos de llamadas en varios idiomas como Python, Node.js, cURL, etc.:

• Descarga de código de ejemplo: xinqikeji.feishu.cn/wiki/W4vEwdiCPi3VfTkrL5hcVlDxnQf
• Documentación oficial de Google: ai.google.dev/gemini-api/docs/image-generation

💰 Sugerencia de control de costos: Para la etapa de desarrollo y prueba, se recomienda usar NB2 ($0.035/vez) para ahorrar costos. Después del lanzamiento oficial, cambia a NB Pro ($0.05/vez) para obtener la mejor calidad de imagen. En la plataforma APIYI, solo necesitas modificar el ID del modelo para ambos modelos, sin necesidad de modificar otro código.

OpenClaw Skills Recomendados: 5 Habilidades para Mejorar la Eficiencia de Generación de Imágenes de Nano Banana Pro

La fortaleza de OpenClaw reside en su ecosistema de habilidades. En ClawHub hay más de 5.490 habilidades comunitarias, y las siguientes 5 están más relacionadas con la generación de imágenes:

Habilidad 1: Image Generator (Asistente de Generación de Imágenes)

El valor central de esta habilidad es la optimización de indicaciones. Solo necesitas decir "dibuja un gato por favor", y se expandirá automáticamente a una indicación profesional que incluye detalles de estilo, iluminación y composición, mejorando significativamente la calidad de las imágenes generadas por NB Pro.

Habilidad 2: Batch Image Creator (Creador de Imágenes por Lotes)

Ideal para escenarios que requieren la generación de múltiples imágenes a la vez, como imágenes de productos de comercio electrónico, calendarios de contenido semanal para redes sociales, etc. Esta habilidad puede:

• Generar lotes de imágenes con diferentes ángulos/estilos a partir de un tema.
• Gestionar automáticamente la cola de generación para evitar la limitación de velocidad.
• Soporte para indicaciones basadas en plantillas, reemplazando variables clave para generar lotes de imágenes.

Habilidad 3: Image Editor (Editor de Imágenes)

NB Pro no solo genera imágenes, sino que también admite la edición basada en imágenes de referencia. Esta habilidad encapsula el flujo de trabajo de edición de imágenes:

• Sube la imagen original + descripción textual de la solicitud de modificación.
• Soporta modificaciones localizadas (cambiar fondo, modificar color, añadir elementos).
• Procesa automáticamente la conversión de formato de imagen y la codificación Base64.

Habilidad 4: Social Media Poster (Publicador en Redes Sociales)

Una habilidad de generación de imágenes diseñada específicamente para redes sociales:

• Incluye plantillas de tamaño óptimo para plataformas como Instagram, Twitter, Xiaohongshu, etc.
• Genera automáticamente pósteres con texto (aprovechando la excelente capacidad de renderizado de texto de NB Pro).
• Soporta la configuración de colores y consistencia de marca.

Habilidad 5: Heartbeat Image Scheduler (Programador de Generación de Imágenes)

Utiliza el exclusivo mecanismo Heartbeat de OpenClaw para lograr la generación automática de imágenes programada:

• Configura expresiones Cron para activar la generación de imágenes a intervalos regulares.
• Por ejemplo, "genera una imagen de saludo matutino todos los días a las 8:00".
• Las imágenes generadas se envían automáticamente a la plataforma de mensajería especificada.
• Ideal para que los equipos de operaciones automaticen la producción de contenido.

Método de Instalación de Habilidades

Instalar habilidades en OpenClaw es muy sencillo:

# Instalar a través de ClawHub
openclaw skill install image-generator

# O pedirle a la IA que instale directamente en el mensaje
# Envía: "Instala la habilidad image-generator"

También puedes explorar el catálogo completo de habilidades en el sitio web de ClawHub: clawhub.openclaw.ai

🎯 Mejor Práctica: Se recomienda instalar primero la habilidad Image Generator, ya que te ayudará a optimizar automáticamente las indicaciones, mejorando significativamente la calidad de las imágenes generadas por NB Pro. Combinado con la ventaja de bajo costo de APIYI apiyi.com, puedes iterar varias veces con confianza para encontrar rápidamente el resultado más satisfactorio.

Nano Banana Pro vs NB2: Cómo Elegir en OpenClaw

APIYI soporta tanto los modelos NB Pro como NB2, y ambos se han añadido a la configuración de OpenClaw. Elige el modelo adecuado según el escenario:

Cambiar el modelo en OpenClaw solo requiere modificar la instrucción del mensaje:

# Usar NB Pro para generar imágenes (por defecto)
Usa NB Pro para generar una imagen promocional de producto

# Cambiar a NB2 para generación rápida de imágenes
Usa NB2 para generar rápidamente 5 opciones de logo en diferentes estilos

O cambia el modelo predeterminado temporalmente en el archivo de configuración:

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

Preguntas Frecuentes

Resumen: Puntos Clave para Conectar OpenClaw con Nano Banana Pro

Pasos principales para conectar OpenClaw con Nano Banana Pro:

1. Obtener clave: Regístrate en APIYI apiyi.com y obtén tu clave API.
2. Editar configuración: Añade el proveedor APIYI en ~/.openclaw/openclaw.json, configurando api como google-generative-ai.
3. Seleccionar modelo: NB Pro ($0.05/llamada, máxima calidad) o NB2 ($0.035/llamada, prioriza velocidad).
4. Instalar Skills: Instala habilidades como Image Generator desde ClawHub para mejorar la eficiencia.
5. Generar imágenes: Envía descripciones en lenguaje natural en cualquier plataforma de mensajería para generar imágenes.

Nano Banana Pro es el modelo principal con el mayor consumo diario en APIYI. La plataforma ha invertido muchos recursos de operación y mantenimiento para garantizar su estabilidad, asegurando transferencia directa oficial, sin límites de velocidad y apto para uso comercial. El precio unificado para todas las resoluciones, de 1K a 4K, es de $0.05 por llamada, mientras que el servicio equivalente en el sitio web oficial cuesta $0.234, solo alrededor del 20% del precio.

Se recomienda acceder a Nano Banana Pro a través de APIYI apiyi.com y combinarlo con el ecosistema de Skills de OpenClaw para construir un flujo de trabajo de generación de imágenes de IA eficiente.

Soporte técnico: APIYI apiyi.com — Plataforma de reenvío de API de Modelos de Lenguaje Grandes de IA estable y confiable, con toda la serie NB Pro a partir del 20% de descuento.