OpenClaw : intégration du service proxy API Nano Banana Pro – Tutoriel complet : 3 étapes de configuration + 5 compétences recommandées

OpenClaw s'associe à Nano Banana Pro : le meilleur agent IA open source rencontre la meilleure génération d'images

OpenClaw est la plateforme d'agents IA open source la plus populaire sur GitHub (plus de 250 000 étoiles), tandis que Nano Banana Pro est le modèle phare de génération d'images de Google DeepMind. La combinaison des deux signifie que vous pouvez utiliser des capacités de génération d'images de niveau studio sur plus de 12 plateformes comme WhatsApp, Telegram, Slack, etc., à tout moment. De plus, grâce à APIYI, NB Pro offre toutes les résolutions de 1K à 4K au même prix de 0,05 $ par appel, soit 20 % du prix du site officiel.

Valeur principale : À la fin de cet article, vous aurez configuré OpenClaw + NB Pro, maîtrisé la méthode d'appel de code et découvert 5 compétences OpenClaw qui amélioreront considérablement l'efficacité de la génération d'images.

Présentation de la plateforme OpenClaw : pourquoi choisir cette plateforme pour intégrer Nano Banana Pro

Avant de commencer la configuration, examinons rapidement les capacités principales d'OpenClaw et pourquoi c'est la plateforme idéale pour intégrer NB Pro.

Aperçu rapide des informations clés d'OpenClaw

Ce qui rend OpenClaw unique, c'est son mécanisme « Heartbeat » : l'IA peut s'activer elle-même via des tâches Cron et des Webhooks, sans nécessiter votre intervention. Cela signifie que vous pouvez définir des flux de travail automatisés tels que « générer automatiquement le matériel marketing du jour à 9h du matin », combiné aux capacités de génération d'images de NB Pro, pour une création IA véritablement autonome.

🚀 Expérience rapide : Si vous n'avez pas encore installé OpenClaw, vous pouvez d'abord tester les résultats de génération d'images de NB Pro en ligne sur imagen.apiyi.com avant de décider de l'intégrer. APIYI offre des crédits de test gratuits, vous permettant de générer des images sans aucune configuration.

Installation d'OpenClaw

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

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

Après l'installation, exécutez la commande openclaw pour lancer l'assistant de configuration.

OpenClaw et l'API Nano Banana Pro : Configuration en 3 étapes

L'idée principale pour intégriser l'API est simple : enregistrer APIYI comme fournisseur de modèles personnalisé dans OpenClaw, puis configurer le modèle Nano Banana Pro. APIYI est entièrement compatible avec le format de l'API Google officielle, il suffit donc de remplacer l'URL de requête et la clé API.

Étape 1 : Obtenir une clé API APIYI

1. Rendez-vous sur le site officiel d'APIYI, apiyi.com, pour créer un compte.
2. Accédez à la console et créez une nouvelle clé API.
3. Vérifiez que Nano Banana Pro (gemini-3-pro-image-preview) est activé dans la liste des modèles.

Étape 2 : Modifier le fichier de configuration OpenClaw

Ouvrez le fichier de configuration d'OpenClaw ~/.openclaw/openclaw.json et ajoutez APIYI comme fournisseur personnalisé :

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

Étape 3 : Définir le modèle de génération d'images par défaut

Dans le même fichier de configuration, spécifiez NB Pro comme modèle de génération d'images par défaut :

{
  "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-your-apiyi-key-here",
        "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
            }
          }
        ]
      }
    }
  }
}

Une fois la configuration terminée, redémarrez OpenClaw pour qu'elle prenne effet.

Points clés de la configuration d'OpenClaw avec NB Pro

💡 Note importante : Le champ api doit être défini sur google-generative-ai et non sur openai-completions. NB Pro utilise le point de terminaison natif generateContent de Google, et APIYI est entièrement compatible avec ce format. Si vous utilisez le mode compatible OpenAI, la fonctionnalité de génération d'images ne fonctionnera pas correctement.

Appel de code API Nano Banana Pro : Utilisation directe du format officiel

APIYI est entièrement compatible avec le format d'appel de la documentation officielle de Google. Si vous utilisez déjà l'API Google officielle, il vous suffit d'apporter deux modifications :

1. Remplacer l'URL de requête : Changez generativelanguage.googleapis.com en api.apiyi.com.
2. Remplacer la clé API : Utilisez la clé fournie par APIYI.

Exemple d'appel de code Nano Banana Pro (Python)

import google.generativeai as genai

# Configuration du point de terminaison APIYI — il suffit de remplacer l'URL et la clé API
genai.configure(
    api_key="your-apiyi-key",
    client_options={"api_endpoint": "api.apiyi.com"}
)

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

response = model.generate_content(
    "Un chat roux assis sur le rebord d'une fenêtre regardant la pluie, style anime japonais, éclairage intérieur chaleureux",
    generation_config=genai.GenerationConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config={"image_size": "2K", "aspect_ratio": "16:9"}
    )
)

# Extraire l'image générée
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("Image enregistrée : output.png")
    elif hasattr(part, "text"):
        print(f"Description : {part.text}")

curl -X POST "https://api.apiyi.com/v1/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: your-apiyi-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Génère une image d'une ville cyberpunk la nuit, avec des néons se reflétant sur les rues mouillées"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "imageSize": "4K",
        "aspectRatio": "21:9"
      }
    }
  }'

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

// Configuration du point de terminaison APIYI
const genAI = new GoogleGenerativeAI("your-apiyi-key", {
  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: "Une peinture à l'encre de Chine de paysages montagneux chinois, avec des montagnes lointaines et de l'eau proche, dans un style épuré" }]
    }],
    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("Image enregistrée : output.png");
    }
  }
}

generateImage();

Paramètres de résolution complète de Nano Banana Pro

🎯 Avantage coût : NB Pro est au prix fixe de 0,05 $/appel pour toutes les résolutions de 1K à 4K sur APIYI. Cela signifie que le coût de génération d'une image ultra haute définition 4K (4096×4096) est identique à celui d'une image 1K. Vous pouvez donc choisir 4K pour obtenir la meilleure qualité d'image.

Test et validation de la génération d'images avec OpenClaw Nano Banana Pro

Une fois la configuration terminée, vous pouvez envoyer directement des messages dans OpenClaw pour tester la génération d'images.

Test dans OpenClaw

Envoyez directement dans n'importe quelle plateforme de messagerie connectée (Telegram, WhatsApp, etc.) :

Génère-moi une image : un Shiba Inu portant des lunettes de soleil surfant sur une plage, ensoleillé, style dessin animé

OpenClaw appellera automatiquement le modèle NB Pro configuré, générera l'image et la renverra dans la conversation.

Test de génération d'images en ligne

Si vous souhaitez d'abord tester la qualité de génération d'images de NB Pro avant de configurer OpenClaw, vous pouvez utiliser l'outil de test en ligne fourni par APIYI :

• Adresse de test de génération d'images : imagen.apiyi.com
• Pas besoin d'écrire de code, il suffit de saisir l'invite en ligne pour générer des images.
• Prend en charge tous les paramètres de résolution et de rapport hauteur/largeur.
• Idéal pour vérifier rapidement l'efficacité des invites.

Téléchargement d'exemples de code

APIYI fournit un package complet de code de référence pour le développement, incluant des exemples d'appels dans plusieurs langages tels que Python, Node.js, cURL, etc. :

• Téléchargement d'exemples de code : xinqikeji.feishu.cn/wiki/W4vEwdiCPi3VfTkrL5hcVlDxnQf
• Documentation officielle de Google : ai.google.dev/gemini-api/docs/image-generation

💰 Conseil de contrôle des coûts : Pour la phase de développement et de test, il est recommandé d'utiliser NB2 (0,035 $/appel) pour économiser sur les coûts. Une fois en production, passez à NB Pro (0,05 $/appel) pour obtenir la meilleure qualité d'image. Sur la plateforme APIYI, il suffit de modifier l'ID du modèle pour les deux modèles, sans avoir à modifier le reste du code.

OpenClaw Skills : 5 compétences pour améliorer l'efficacité de génération d'images avec Nano Banana Pro

La force d'OpenClaw réside dans son écosystème de compétences. Sur ClawHub, on trouve plus de 5 490 compétences communautaires. Voici 5 d'entre elles, particulièrement pertinentes pour la génération d'images :

Compétence 1 : Image Generator (Assistant de génération d'images)

La valeur principale de cette compétence réside dans l'optimisation des invites. Il vous suffit de dire "Dessine-moi un chat", et elle l'étendra en une invite professionnelle incluant des détails sur le style, l'éclairage et la composition, améliorant ainsi considérablement la qualité des images générées par NB Pro.

Compétence 2 : Batch Image Creator (Générateur d'images en lot)

Idéal pour les scénarios nécessitant la génération de plusieurs images en une seule fois, comme pour les fiches produits e-commerce ou les calendriers de contenu hebdomadaires pour les réseaux sociaux. Cette compétence permet de :

• Générer en lot plusieurs images sous différents angles/styles à partir d'un seul thème.
• Gérer automatiquement la file d'attente de génération pour éviter les limitations de débit.
• Utiliser des invites basées sur des modèles, en remplaçant simplement les variables clés pour générer des images en lot.

Compétence 3 : Image Editor (Éditeur d'images)

NB Pro ne se contente pas de générer des images, il prend également en charge l'édition basée sur des images de référence. Cette compétence encapsule le flux de travail d'édition d'images :

• Téléchargez l'image originale + une description textuelle des modifications souhaitées.
• Prend en charge les modifications locales (changement d'arrière-plan, modification de couleur, ajout d'éléments).
• Gère automatiquement la conversion des formats d'image et l'encodage Base64.

Compétence 4 : Social Media Poster (Afficheur pour réseaux sociaux)

Une compétence de génération d'images spécialement conçue pour les réseaux sociaux :

• Intègre des modèles aux dimensions optimales pour des plateformes comme Instagram, Twitter, Xiaohongshu, etc.
• Génère automatiquement des affiches avec du texte (en exploitant les excellentes capacités de rendu de texte de NB Pro).
• Prend en charge la définition des couleurs de marque et la cohérence stylistique.

Compétence 5 : Heartbeat Image Scheduler (Planificateur d'images)

Utilise le mécanisme exclusif Heartbeat d'OpenClaw pour automatiser la génération d'images à des moments précis :

• Définissez une expression Cron pour déclencher la génération d'images à intervalles réguliers.
• Par exemple, "Générer une image de bonjour chaque jour à 8h00".
• Les images générées sont automatiquement envoyées à une plateforme de messagerie désignée.
• Idéal pour les équipes marketing afin d'automatiser la production de contenu.

Méthode d'installation des compétences

Installer une compétence dans OpenClaw est très simple :

# Installer via ClawHub
openclaw skill install image-generator

# Ou demander à l'IA de l'installer directement dans un message
# Envoyer : "Installer la compétence image-generator"

Vous pouvez également parcourir le catalogue complet des compétences sur le site ClawHub : clawhub.openclaw.ai

🎯 Meilleure pratique : Il est recommandé d'installer d'abord la compétence Image Generator. Elle vous aidera à optimiser automatiquement vos invites, améliorant ainsi considérablement la qualité des images générées par NB Pro. Combiné à l'avantage de coût d'APIYI apiyi.com, vous pouvez itérer plusieurs fois en toute confiance pour obtenir rapidement les meilleurs résultats.

Nano Banana Pro vs NB2 : Comment choisir dans OpenClaw

APIYI prend en charge les deux modèles, NB Pro et NB2, qui ont tous deux été ajoutés dans la configuration d'OpenClaw. Choisissez le modèle approprié en fonction de vos besoins :

Dans OpenClaw, changer de modèle ne nécessite que de modifier l'instruction de message :

# Utiliser NB Pro pour générer une image (par défaut)
Utilise NB Pro pour générer une image promotionnelle de produit

# Passer à NB2 pour une génération rapide
Utilise NB2 pour générer rapidement 5 propositions de logo de styles différents

Ou changez temporairement le modèle par défaut dans le fichier de configuration :

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

Foire aux questions

Résumé : Points clés pour connecter OpenClaw à Nano Banana Pro

Étapes clés pour connecter OpenClaw à Nano Banana Pro :

1. Obtenir une clé : Inscrivez-vous sur APIYI apiyi.com et obtenez votre clé API.
2. Modifier la configuration : Ajoutez le fournisseur APIYI dans ~/.openclaw/openclaw.json et définissez api sur google-generative-ai.
3. Choisir le modèle : NB Pro (0,05 $/appel, meilleure qualité d'image) ou NB2 (0,035 $/appel, priorité à la vitesse).
4. Installer des Skills : Installez des compétences comme Image Generator via ClawHub pour améliorer l'efficacité.
5. Commencer la génération : Envoyez une description en langage naturel sur n'importe quelle plateforme de messagerie pour générer des images.

Nano Banana Pro est le modèle principal avec la plus forte consommation quotidienne sur APIYI. La plateforme a investi massivement en ressources d'exploitation pour maintenir sa stabilité, garantissant un transfert direct officiel, sans limitation de vitesse et utilisable commercialement. Le prix unifié pour toutes les résolutions de 1K à 4K est de 0,05 $/appel, contre 0,234 $/appel pour le même service sur le site officiel, soit environ 20 % du prix.

Il est recommandé d'accéder à Nano Banana Pro via APIYI apiyi.com et de le combiner avec l'écosystème de Skills d'OpenClaw pour construire un flux de travail de génération d'images IA efficace.

Support technique : APIYI apiyi.com — Plateforme de transfert d'API de grands modèles d'IA stable et fiable, à partir de 20 % du prix pour toute la série NB Pro.