Tutorial Lengkap OpenClaw Mengintegrasikan API Nano Banana Pro: 3 Langkah Konfigurasi + 5 Skill yang Direkomendasikan

OpenClaw Terhubung dengan Nano Banana Pro: Agen AI Open-Source Terkuat Bertemu Generasi Gambar Terkuat

OpenClaw adalah platform agen AI open-source terpanas di GitHub saat ini (250 ribu+ Bintang), sementara Nano Banana Pro adalah model generasi gambar unggulan yang diluncurkan oleh Google DeepMind. Menggabungkan keduanya berarti Anda dapat memanggil kemampuan generasi gambar AI setara Studio kapan saja di 12+ platform seperti WhatsApp, Telegram, Slack, dll. — dan melalui APIYI, NB Pro resolusi penuh 1K hingga 4K harganya sama, hanya $0.05/panggilan, setara dengan 20% harga resmi.

Nilai Inti: Setelah membaca artikel ini, Anda akan menyelesaikan konfigurasi koneksi OpenClaw + NB Pro, menguasai metode pemanggilan kode, dan mempelajari 5 Keterampilan OpenClaw yang dapat secara signifikan meningkatkan efisiensi pembuatan gambar.

Pengenalan Platform OpenClaw: Mengapa Memilihnya untuk Menghubungkan Nano Banana Pro

Sebelum konfigurasi, mari kita tinjau sekilas kemampuan inti OpenClaw dan mengapa ini adalah platform yang ideal untuk menghubungkan NB Pro.

Ikhtisar Informasi Inti OpenClaw

Keunikan OpenClaw terletak pada mekanisme "Heartbeat"—AI dapat membangunkan dirinya sendiri secara proaktif melalui tugas Cron dan Webhook, tanpa perlu Anda memicunya dengan pesan. Ini berarti Anda dapat mengatur alur kerja otomatis seperti "buat materi pemasaran harian secara otomatis pada jam 9 pagi", yang dikombinasikan dengan kemampuan generasi gambar NB Pro, untuk mewujudkan kreasi AI tanpa pengawasan.

🚀 Pengalaman Cepat: Jika Anda belum menginstal OpenClaw, Anda dapat mencoba efek output gambar NB Pro secara online terlebih dahulu di imagen.apiyi.com sebelum memutuskan untuk menghubungkannya. APIYI menyediakan kuota uji coba gratis, Anda bisa mendapatkan gambar tanpa konfigurasi.

Instalasi OpenClaw

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

# Atau gunakan npm
npm install -g @openclaw/openclaw

Setelah instalasi selesai, jalankan perintah openclaw untuk memulai panduan konfigurasi.

OpenClaw Integrasi API Nano Banana Pro: Konfigurasi dalam 3 Langkah

Inti dari integrasi ini sangat sederhana: daftarkan APIYI sebagai penyedia model kustom di OpenClaw, lalu konfigurasikan model Nano Banana Pro. APIYI sepenuhnya kompatibel dengan format API resmi Google, jadi Anda hanya perlu mengganti URL permintaan dan kunci API.

Langkah 1: Dapatkan Kunci API APIYI

1. Kunjungi situs web resmi APIYI di apiyi.com untuk mendaftar akun.
2. Masuk ke konsol dan buat Kunci API baru.
3. Pastikan Nano Banana Pro (gemini-3-pro-image-preview) telah diaktifkan di daftar model.

Langkah 2: Edit File Konfigurasi OpenClaw

Buka file konfigurasi OpenClaw ~/.openclaw/openclaw.json dan tambahkan APIYI sebagai penyedia kustom:

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

Langkah 3: Atur Model Pembuatan Gambar Default

Dalam file konfigurasi yang sama, tetapkan NB Pro sebagai model pembuatan gambar default:

{
  "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-kunci-apiyi-anda-disini",
        "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
            }
          }
        ]
      }
    }
  }
}

Setelah konfigurasi selesai, restart OpenClaw agar perubahan berlaku.

Poin Penting Konfigurasi OpenClaw untuk NB Pro

💡 Catatan Penting: Kolom api harus diatur ke google-generative-ai, bukan openai-completions. NB Pro menggunakan endpoint generateContent asli Google, dan APIYI sepenuhnya kompatibel dengan format ini. Jika Anda menggunakan mode kompatibel OpenAI, fungsi pembuatan gambar tidak akan berfungsi dengan benar.

Panggilan Kode API Nano Banana Pro: Gunakan Langsung Format Resmi

APIYI sepenuhnya kompatibel dengan format panggilan dokumentasi resmi Google. Jika Anda sudah menggunakan API resmi Google, Anda hanya perlu melakukan dua modifikasi:

1. Ganti URL Permintaan: Ubah generativelanguage.googleapis.com menjadi api.apiyi.com.
2. Ganti Kunci API: Gunakan kunci yang disediakan oleh APIYI.

Contoh Panggilan Kode Nano Banana Pro (Python)

import google.generativeai as genai

# Konfigurasi endpoint APIYI — cukup ganti alamat dan kunci API
genai.configure(
    api_key="kunci-apiyi-anda",
    client_options={"api_endpoint": "api.apiyi.com"}
)

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

response = model.generate_content(
    "Seekor kucing oranye duduk di ambang jendela melihat hujan, gaya anime Jepang, pencahayaan interior yang hangat",
    generation_config=genai.GenerationConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config={"image_size": "2K", "aspect_ratio": "16:9"}
    )
)

# Ekstrak gambar yang dihasilkan
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("Gambar telah disimpan: output.png")
    elif hasattr(part, "text"):
        print(f"Deskripsi: {part.text}")

curl -X POST "https://api.apiyi.com/v1/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: kunci-apiyi-anda" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Hasilkan pemandangan malam kota bergaya cyberpunk, lampu neon terpantul di jalan yang basah"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "imageSize": "4K",
        "aspectRatio": "21:9"
      }
    }
  }'

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

// Konfigurasi endpoint APIYI
const genAI = new GoogleGenerativeAI("kunci-apiyi-anda", {
  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: "Lukisan gaya tinta Tiongkok pemandangan gunung dan sungai, gunung jauh dan air dekat, dengan ruang kosong yang artistik" }]
    }],
    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("Gambar telah disimpan: output.png");
    }
  }
}

generateImage();

Penjelasan Parameter Resolusi Penuh Nano Banana Pro

🎯 Keunggulan Biaya: NB Pro di APIYI memiliki harga tetap $0.05/permintaan untuk semua resolusi dari 1K hingga 4K. Ini berarti biaya untuk menghasilkan gambar ultra-HD 4K (4096×4096) sama persis dengan 1K. Pilih 4K langsung untuk kualitas gambar terbaik.

Pengujian dan Verifikasi Output Gambar OpenClaw Nano Banana Pro

Setelah konfigurasi selesai, Anda dapat langsung mengirim pesan di OpenClaw untuk menguji hasil pembuatan gambar.

Pengujian di OpenClaw

Kirim langsung di platform pesan yang terhubung (Telegram, WhatsApp, dll.):

Buatkan saya gambar: seekor anjing Shiba Inu memakai kacamata hitam sedang berselancar di pantai, cuaca cerah, gaya kartun

OpenClaw akan secara otomatis memanggil model NB Pro yang dikonfigurasi, menghasilkan gambar, dan membalasnya di dalam percakapan.

Pengujian Output Gambar Online

Jika Anda ingin menguji kualitas gambar NB Pro terlebih dahulu sebelum mengonfigurasi OpenClaw, Anda dapat menggunakan alat pengujian online yang disediakan oleh APIYI:

• Alamat Pengujian Output Gambar: imagen.apiyi.com
• Tidak perlu menulis kode, cukup masukkan petunjuk secara online untuk menghasilkan gambar.
• Mendukung semua parameter resolusi dan rasio aspek.
• Cocok untuk memverifikasi efek petunjuk dengan cepat.

Unduh Contoh Kode

APIYI menyediakan paket kode referensi pengembangan yang lengkap, termasuk contoh pemanggilan dalam berbagai bahasa seperti Python, Node.js, cURL, dll.:

• Unduh Kode Contoh: xinqikeji.feishu.cn/wiki/W4vEwdiCPi3VfTkrL5hcVlDxnQf
• Dokumentasi Resmi Google: ai.google.dev/gemini-api/docs/image-generation

💰 Saran Pengendalian Biaya: Untuk tahap pengembangan dan pengujian, disarankan menggunakan NB2 ($0.035/kali) untuk menghemat biaya. Setelah peluncuran resmi, beralihlah ke NB Pro ($0.05/kali) untuk mendapatkan kualitas gambar terbaik. Di platform APIYI, kedua model hanya memerlukan perubahan ID model, tanpa perlu mengubah kode lainnya.

OpenClaw Skills Rekomendasi: 5 Skill untuk Meningkatkan Efisiensi Pembuatan Gambar Nano Banana Pro

Kekuatan OpenClaw terletak pada ekosistem skill-nya. Di ClawHub terdapat lebih dari 5.490 skill komunitas, berikut 5 yang paling relevan dengan pembuatan gambar:

Skill 1: Image Generator (Asisten Pembuatan Gambar)

Nilai inti dari Skill ini adalah optimasi petunjuk. Anda hanya perlu mengatakan "Buatkan saya gambar kucing", dan skill ini akan secara otomatis mengembangkannya menjadi petunjuk profesional yang mencakup detail gaya, pencahayaan, dan komposisi, sehingga secara signifikan meningkatkan kualitas gambar yang dihasilkan NB Pro.

Skill 2: Batch Image Creator (Pembuat Gambar Batch)

Cocok untuk skenario yang membutuhkan pembuatan banyak gambar sekaligus, seperti gambar produk e-commerce, kalender konten mingguan media sosial, dll. Skill ini dapat:

• Menghasilkan banyak gambar dari sudut/gaya yang berbeda berdasarkan satu tema
• Mengelola antrean pembuatan secara otomatis untuk menghindari pembatasan laju
• Mendukung petunjuk terstruktur, cukup ganti variabel kunci untuk membuat gambar secara batch

Skill 3: Image Editor (Editor Gambar)

NB Pro tidak hanya dapat menghasilkan gambar, tetapi juga mendukung pengeditan berdasarkan gambar referensi. Skill ini membungkus alur kerja pengeditan gambar:

• Unggah gambar asli + permintaan modifikasi deskripsi teks
• Mendukung modifikasi lokal (mengubah latar belakang, warna, menambahkan elemen)
• Secara otomatis menangani konversi format gambar dan pengkodean Base64

Skill 4: Social Media Poster (Poster Media Sosial)

Skill pembuatan gambar yang dirancang khusus untuk media sosial:

• Template ukuran optimal bawaan untuk platform seperti Instagram, Twitter, Xiaohongshu, dll.
• Menghasilkan poster dengan teks secara otomatis (memanfaatkan kemampuan rendering teks NB Pro yang unggul)
• Mendukung pengaturan konsistensi warna dan gaya merek

Skill 5: Heartbeat Image Scheduler (Penjadwal Gambar Otomatis)

Memanfaatkan mekanisme Heartbeat unik OpenClaw untuk mewujudkan pembuatan gambar otomatis terjadwal:

• Tetapkan ekspresi Cron untuk memicu pembuatan gambar secara terjadwal
• Contoh: "Buat gambar ucapan selamat pagi setiap hari pukul 08:00"
• Gambar yang dihasilkan secara otomatis dikirim ke platform pesan yang ditentukan
• Cocok untuk tim operasional dalam otomatisasi produksi konten

Cara Instalasi Skill

Menginstal Skill di OpenClaw sangat mudah:

# Instal melalui ClawHub
openclaw skill install image-generator

# Atau minta AI untuk menginstal langsung dalam pesan
# Kirim: "Instal skill image-generator"

Anda juga dapat menelusuri katalog skill lengkap di situs web ClawHub: clawhub.openclaw.ai

🎯 Praktik Terbaik: Direkomendasikan untuk menginstal Skill Image Generator terlebih dahulu, karena dapat membantu Anda mengoptimalkan petunjuk secara otomatis dan secara signifikan meningkatkan kualitas gambar yang dihasilkan NB Pro. Dikombinasikan dengan keunggulan biaya rendah dari APIYI apiyi.com, Anda dapat melakukan iterasi berkali-kali tanpa khawatir, dan dengan cepat menemukan hasil yang paling memuaskan.

Nano Banana Pro vs NB2: Cara Memilih di OpenClaw

APIYI mendukung kedua model, NB Pro dan NB2, dan keduanya telah ditambahkan dalam konfigurasi OpenClaw. Pilih model yang sesuai berdasarkan skenario yang berbeda:

Mengganti model di OpenClaw hanya perlu mengubah instruksi pesan:

# Gunakan NB Pro untuk membuat gambar (default)
Gunakan NB Pro untuk membuatkan saya gambar promosi produk

# Beralih ke NB2 untuk pembuatan gambar cepat
Gunakan NB2 untuk membuat cepat 5 opsi desain Logo dengan gaya berbeda

Atau ubah model default sementara di file konfigurasi:

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

Pertanyaan Umum

Ringkasan: Poin Inti Menghubungkan OpenClaw + Nano Banana Pro

Langkah-langkah inti untuk menghubungkan OpenClaw ke Nano Banana Pro:

1. Dapatkan Kunci: Daftar di APIYI apiyi.com dan dapatkan Kunci API.
2. Edit Konfigurasi: Tambahkan penyedia APIYI di ~/.openclaw/openclaw.json, atur api ke google-generative-ai.
3. Pilih Model: NB Pro ($0,05/permintaan, kualitas gambar tertinggi) atau NB2 ($0,035/permintaan, prioritas kecepatan).
4. Instal Skills: Instal keterampilan seperti Image Generator melalui ClawHub untuk meningkatkan efisiensi.
5. Mulai Menghasilkan Gambar: Kirim deskripsi bahasa alami di platform pesan apa pun untuk menghasilkan gambar.

Nano Banana Pro adalah model utama dengan konsumsi harian tertinggi di APIYI, dan platform telah menginvestasikan banyak sumber daya operasional dan pemeliharaan untuk menjaga stabilitasnya—memastikan penerusan langsung resmi, tanpa batasan kecepatan, dan dapat digunakan secara komersial. Harga seragam untuk semua resolusi dari 1K hingga 4K adalah $0,05/permintaan, sedangkan layanan yang setara di situs web resmi adalah $0,234/permintaan, hanya sekitar 20% dari harga asli.

Disarankan untuk mengakses Nano Banana Pro melalui APIYI apiyi.com, dikombinasikan dengan ekosistem Skills OpenClaw, untuk membangun alur kerja pembuatan gambar AI yang efisien.

Dukungan Teknis: APIYI apiyi.com — Platform perantara API Model Bahasa Besar AI yang stabil dan andal, seri NB Pro mulai dari diskon 20%