Ingin agar OpenClaw bisa langsung memanggil model gambar tercanggih OpenAI, gpt-image-2? Apa yang pertama kali terlintas di pikiran Anda? Kebanyakan orang akan langsung membuka editor, menulis skrip Python requests.post(...), lalu membungkusnya menjadi fungsi alat (tool function) untuk diberikan kepada Agen.
Cara ini bukan tidak bisa dilakukan, tetapi Anda akan langsung terjebak dalam empat masalah:
- Harus menangani unggahan gambar referensi
multipart/form-data. - Harus menulis logika retry/timeout/pembatasan rate limit 429.
- Harus menulis paket pembungkus terpisah untuk setiap skenario (teks ke gambar, gambar ke gambar, Mask, batch).
- Harus melakukan integrasi ulang setiap kali mengganti klien OpenClaw (atau Claude Code, Cursor).
Jawaban di tahun 2026 sudah berubah: Jangan menulis kode, cukup pasang Skill.
OpenClaw mendukung ekosistem Skill yang lengkap—registri ClawHub saat ini sudah memiliki 5700+ Skill kontribusi komunitas. Artikel ini akan membagikan dua Skill resmi gpt-image-2 yang dikontribusikan oleh tim APIYI ke repositori expert-skills-hub:
apiyi-gpt-image-2-gen(Mode standar / kontrol presisi, direkomendasikan)apiyi-gpt-image-2-all-gen(Mode terbalik / mode ekonomis)
Memasang Skill hanya butuh satu baris perintah, mengatur kunci API hanya butuh satu baris export, lalu Anda bisa langsung berkata di OpenClaw, "Bantu saya buat gambar produk cangkir keramik 4K", dan Agen akan otomatis memilih Skill, mengisi parameter, dan menyimpan file.
Setelah menyelesaikan tutorial Integrasi OpenClaw dengan gpt-image-2 ini, Anda akan mendapatkan:
- Perbandingan yang jelas antara "menulis kode vs memasang Skill", dan alasan mengapa yang terakhir lebih baik.
- Dua Skill resmi yang siap pakai, mencakup skenario output berkualitas tinggi dan skenario batch ekonomis.
- Contoh minimal yang bisa dijalankan dalam 5 langkah (masing-masing untuk Node.js dan Python).
- Tiga perintah praktis (poster 4K / sintesis multi-gambar referensi / sketsa batch).
- Cara menggunakan kembali rangkaian Skill yang sama di Claude Code dan Cursor.
I. Mengapa Skill adalah solusi terbaik untuk integrasi OpenClaw dengan gpt-image-2
1.1 Sistem Skill OpenClaw: Cara standar untuk memberikan "kekuatan tambahan" pada Agen
OpenClaw adalah asisten AI sumber terbuka lintas platform (repositori GitHub github.com/openclaw/openclaw). Tujuan desainnya bukan untuk menjadi "kotak obrolan biasa", melainkan untuk "menyediakan kotak peralatan yang dapat dikombinasikan bagi Agen". Unit dasar dari kotak peralatan ini disebut Skill.
Sebuah Skill pada dasarnya terdiri dari:
skill-package/
├── SKILL.md # Memberi tahu Agen apa fungsi Skill ini
├── scripts/
│ ├── generate_image.js # Runtime Node.js
│ └── generate_image.py # Runtime Python
└── requirements.txt / package.json
Saat Anda berkata "Bantu saya menggambar cangkir kopi", OpenClaw akan:
- Memindai ringkasan
SKILL.mddari semua Skill yang terpasang. - Menentukan bahwa "pembuatan gambar" paling cocok dengan
apiyi-gpt-image-2-gen. - Mengekstrak parameter dari bahasa alami Anda (ukuran, kualitas, format output).
- Memanggil
generate_image.js/pyyang sesuai. - Mengembalikan jalur gambar yang dihasilkan kepada Anda.
Seluruh proses ini tidak memerlukan penulisan kode, konfigurasi rute, atau pemanggilan SDK. Inilah keunggulan inti ekosistem OpenClaw dibandingkan mode "menulis plugin" tradisional.
1.2 Menulis kode vs Memasang Skill: Perbandingan dalam tabel
| Dimensi Perbandingan | Menulis Kode HTTP Manual | Memasang Skill Resmi |
|---|---|---|
| Biaya Awal | Mulai dari 30 menit | 1 baris perintah, 30 detik |
| Detail HTTP | Menangani multipart, retry, timeout sendiri | Sudah dibungkus di dalam Skill |
| Unggah Gambar Referensi | Melakukan pengkodean base64 sendiri | Langsung kirim jalur file |
| Multi-runtime | Harus Node atau Python | Tersedia Node.js + Python |
| Persepsi Agen | Harus menulis deskripsi alat sendiri | Sudah termasuk SKILL.md |
| Lintas Klien | Integrasi ulang saat ganti lingkungan | Kompatibel dengan Claude Code / Cursor / OpenClaw |
| Jalur Pembaruan | Mengikuti pembaruan OpenAI API sendiri | Satu klik dengan npx skills update |
| Pergantian Jalur | Ubah kode | Ubah variabel lingkungan |
Dengan kata lain, menulis kode membuat Anda menjadi pekerja glue yang terus-menerus melakukan pemeliharaan, sementara memasang Skill menyerahkan pekerjaan pemeliharaan kepada pembuat Skill tersebut.
1.3 Pembagian tugas dua Skill: Pilih alat yang tepat sebelum membuat gambar
Tim APIYI telah menyumbangkan dua Skill untuk gpt-image-2 ke repositori expert-skills-hub, yang ditujukan untuk skenario yang sangat berbeda:
| Nama Skill | Alias Model | Posisi | Model Harga | Skenario Terbaik |
|---|---|---|---|---|
apiyi-gpt-image-2-gen |
gpt-image-2 |
Standar / Kontrol presisi | Penagihan per token | Poster, foto komersial, sampul, output 4K |
apiyi-gpt-image-2-all-gen |
gpt-image-2-all |
Terbalik / Mode ekonomis | Tetap $0,03/gambar | Konsep batch, prompt bahasa Mandarin, eksplorasi sketsa |
Kedua Skill berbagi APIYI_API_KEY yang sama, dan backend terpusat melalui gateway APIYI. Anda dapat memasang keduanya sekaligus, membiarkan Agen OpenClaw memilih secara otomatis berdasarkan skenario: membuat poster menggunakan mode standar, menjalankan 100 variasi menggunakan mode ekonomis.
1.4 Backend Dasar: Tiga Jalur APIYI apiyi.com
Permintaan HTTP dari kedua Skill secara default diarahkan ke api.apiyi.com, yang merupakan situs utama APIYI.
🎯 Saran Jalur: Kami menyarankan Anda untuk mengalihkan
APIYI_BASE_URLOpenClaw di lingkungan produksi ke jalur konkurensi tinggi APIYI, yaituvip.apiyi.com, terutama saat menjalankan pembuatan gambar batch. Situs utamaapi.apiyi.comcocok untuk pemanggilan gambar tunggal sehari-hari, jalur VIPvip.apiyi.comcocok untuk antrean batch/malam hari, danb.apiyi.comberfungsi sebagai fallback otomatis. Ketiga jalur tersebut menggunakan satu kunci yang sama, Anda hanya perlu mengubah satu variabel lingkungan untuk beralih.
2. Integrasi OpenClaw dengan gpt-image-2 dalam 5 Menit
2.1 Pemeriksaan Lingkungan Awal
Sebelum mengintegrasikan OpenClaw dengan gpt-image-2, pastikan lingkungan Anda sudah siap:
| Item | Persyaratan | Perintah Verifikasi |
|---|---|---|
| OpenClaw Terinstal | Versi terbaru | openclaw --version |
| Node.js | 18+ | node --version |
| Python | 3.10+ (opsional) | python3 --version |
| npx | Bawaan Node | npx --version |
| Jaringan | Akses ke github.com & api.apiyi.com | curl -I api.apiyi.com |
| Kunci APIYI | Dapatkan dari dasbor api.apiyi.com |
Cek awalan sk- |
⚠️ Catatan: Jika perintah
npx skillstidak ditemukan di versi OpenClaw Anda, silakan perbarui ke versi terbaru (openclaw update). Skills CLI adalah kemampuan inti dari ekosistem OpenClaw 2026, versi lama mungkin belum mendukungnya.
2.2 Langkah 1: Pasang Skill dengan Satu Perintah
Buka terminal Anda dan pasang Skill yang sesuai dengan kebutuhan. Disarankan untuk memasang keduanya:
# Standar (disarankan untuk penggunaan sehari-hari)
npx skills add https://github.com/wuchubuzai2018/expert-skills-hub \
--skill apiyi-gpt-image-2-gen
# Lanjutan (ramah untuk batch/prompt bahasa Mandarin)
npx skills add https://github.com/wuchubuzai2018/expert-skills-hub \
--skill apiyi-gpt-image-2-all-gen
Setelah perintah selesai, Skill akan ditempatkan di direktori Skill default OpenClaw (biasanya ~/.openclaw/skills/). Anda bisa memastikannya dengan perintah berikut:
npx skills list
# Output yang diharapkan:
# - apiyi-gpt-image-2-gen ✓ terinstal
# - apiyi-gpt-image-2-all-gen ✓ terinstal
2.3 Langkah 2: Konfigurasi Kunci API
Integrasi OpenClaw dengan gpt-image-2 hanya memerlukan satu variabel lingkungan:
# macOS / Linux
export APIYI_API_KEY="sk-kunci-anda-di-sini"
# Windows PowerShell
$env:APIYI_API_KEY = "sk-kunci-anda-di-sini"
Disarankan untuk menambahkan baris ini ke ~/.zshrc atau ~/.bashrc agar bersifat permanen.
🎯 Langkah Mendapatkan Kunci: Kunjungi APIYI
apiyi.com, daftar, lalu masuk ke dasbor → API Keys → Buat kunci baru. Disarankan untuk mengaktifkan fitur "Batas Penggunaan" (Usage Limit) dan menetapkan batas harian (misalnya ¥50) khusus untuk kunci yang digunakan OpenClaw guna menghindari konsumsi berlebih akibat kesalahan pemicuan oleh agen.
Pilihan untuk beralih antar 3 jalur, jika Anda memerlukan konkurensi tinggi dalam skenario batch:
export APIYI_BASE_URL="https://vip.apiyi.com/v1" # Jalur VIP
# atau
export APIYI_BASE_URL="https://b.apiyi.com/v1" # Cadangan
Jika tidak diatur, secara default akan menggunakan https://api.apiyi.com/v1.
2.4 Langkah 3: Menjalankan Gambar Pertama (Node.js)
Skill yang terpasang sudah menyertakan skrip contoh. Perintah verifikasi paling sederhana:
cd ~/.openclaw/skills/apiyi-gpt-image-2-gen
node scripts/generate_image.js \
-p "A minimalist poster with the text 'HELLO 2026' centered" \
-s "1024x1024" \
-q "medium" \
-o "png" \
-f "./hello_2026.png"
Setelah sekitar 20–40 detik, terminal akan menampilkan:
✔ Image generated: ./hello_2026.png (1024x1024, png, 312 KB)
Buka hello_2026.png, Anda seharusnya melihat poster minimalis yang bersih dengan teks "HELLO 2026" yang jelas di tengah. Jika teks tidak buram, berarti seluruh alur (OpenClaw Skill → APIYI api.apiyi.com → OpenAI gpt-image-2) sudah berjalan dengan lancar.
2.5 Langkah 4: Menjalankan Gambar Pertama (Versi Python)
Jika proyek Anda menggunakan tumpukan teknologi Python, Skill yang sama juga menyertakan skrip Python:
cd ~/.openclaw/skills/apiyi-gpt-image-2-gen
python3 scripts/generate_image.py \
-p "A minimalist poster with the text 'HELLO 2026' centered" \
-s "1024x1024" \
-q "medium" \
-o "png" \
-f "./hello_2026.png"
Parameter yang digunakan sama persis dengan versi Node.js, yaitu lima opsi singkat -p/-s/-q/-o/-f atau opsi panjang yang sesuai (--prompt/--size/--quality/--output-format/--filename).
💡 Tidak perlu mengganti runtime: Kedua skrip tersedia dalam satu paket Skill, artinya Anda bisa menggunakan Node (ramah frontend) untuk sebagian kode dan Python (ramah data science) untuk bagian lainnya dalam satu proyek. Skill integrasi OpenClaw ke gpt-image-2 melayani keduanya secara setara.
2.6 Langkah 5: Pemanggilan dengan Bahasa Alami di OpenClaw
CLI di atas hanya untuk memverifikasi bahwa Skill berfungsi. Penggunaan yang sebenarnya adalah membiarkan OpenClaw memanggilnya secara mandiri. Setelah menjalankan OpenClaw, berikan perintah langsung menggunakan bahasa alami:
Pengguna: Bantu saya buatkan gambar produk cangkir teh keramik 4K menggunakan gpt-image-2,
cahaya pagi lembut, latar belakang polos, format PNG, simpan ke ./output/tea_cup.png
OpenClaw: Baik, saya akan menggunakan Skill apiyi-gpt-image-2-gen untuk memproses permintaan ini.
Parameter: size=3840x2160, quality=high, output-format=png
Sedang membuat...
✔ Selesai: ./output/tea_cup.png (3840x2160, 2.4 MB)
Lapisan inferensi OpenClaw akan:
- Mengidentifikasi jenis tugas = pembuatan gambar
- Membandingkan
SKILL.mddari kedua Skill, lalu memilihapiyi-gpt-image-2-gen(karena pengguna meminta 4K + PNG) - Menerjemahkan "4K" menjadi
3840x2160, dan menggabungkan "cahaya pagi lembut" ke dalam prompt - Mengeksekusi
generate_image.jsdan mengembalikan jalur file
Seluruh proses ini hanya memerlukan satu kalimat dari Anda, tanpa perlu menulis kode Python/Node. Inilah nilai inti dari integrasi OpenClaw dengan gpt-image-2 melalui jalur Skill.
III. Referensi Cepat Parameter OpenClaw untuk gpt-image-2
3.1 Skill Forward: apiyi-gpt-image-2-gen
Ini adalah tipe kontrol presisi, direkomendasikan untuk penggunaan standar. Berikut tabel parameter lengkapnya:
| Opsi | Opsi Panjang | Rentang Nilai | Default | Penjelasan |
|---|---|---|---|---|
-p |
--prompt |
Teks | Wajib | Deskripsi gambar, disarankan campuran kata kunci Inggris + Indonesia |
-s |
--size |
WIDTHxHEIGHT |
1024x1024 |
Kelipatan 16 apa pun, maksimal dalam 3840x3840 |
-q |
--quality |
low/medium/high/auto | auto |
Pilih high untuk poster, low untuk sketsa |
-o |
--output-format |
png/jpeg/webp | png |
Harus png untuk latar belakang transparan |
-c |
--output-compression |
0-100 | 85 |
Hanya berlaku untuk jpeg/webp |
-i |
--input-image |
Jalur (bisa diulang) | Tidak ada | Maksimal 5 gambar referensi |
-m |
--mask |
Jalur | Tidak ada | Mask hitam putih, putih = area edit |
-f |
--filename |
Jalur | ./output.png |
File output |
Referensi cepat ukuran umum:
| Penggunaan | Ukuran yang Disarankan |
|---|---|
| Instagram Story | 1080x1080 |
| Postingan Vertikal | 1080x1440 |
| Thumbnail Bilibili | 1920x1080 |
| Header Blog | 1600x900 |
| Poster 4K | 3840x2160 |
| Banner Panjang | 2400x800 |
| Wallpaper HP | 1170x2532 |
3.2 Skill Reverse: apiyi-gpt-image-2-all-gen
Ini adalah tipe ekonomis massal, dengan biaya sekitar $0,03 per gambar. Parameternya lebih ringkas:
| Opsi | Opsi Panjang | Rentang Nilai | Penjelasan |
|---|---|---|---|
-p |
--prompt |
Teks | Deskripsi, tulis ukuran/rasio langsung di dalam teks |
-r |
--response-format |
url / b64_json | url mengembalikan tautan CDN 24 jam, b64_json mengembalikan Base64 |
-i |
--input-image |
Jalur (bisa diulang) | Maksimal 5 gambar referensi |
-f |
--filename |
Jalur | File output (otomatis terunduh dalam mode url) |
Skill Reverse tidak mengekspos -s/-q/-o, karena model dasarnya berbasis percakapan, sehingga ukuran harus dinyatakan melalui petunjuk:
# Contoh benar
-p "Buatkan wallpaper landscape 16:9, pemandangan kota fiksi ilmiah malam hari, lampu neon"
# Contoh salah (mode reverse tidak mendukung -s)
-p "Pemandangan kota fiksi ilmiah malam hari" -s "1920x1080" # ❌
3.3 Tiga Perintah Praktis
Praktis 1: Poster Film 4K (Forward)
node scripts/generate_image.js \
-p "Cinematic poster for sci-fi novel 'NEON HORIZON', \
dark blue and magenta gradient sky, lone silhouette on cliff, \
bold serif title centered at top, subtle tagline bottom, \
35mm film grain" \
-s "3840x5760" \
-q "high" \
-o "png" \
-f "./poster_neon_horizon.png"
- Vertikal 2:3 4K
- quality=high memastikan teks tajam
- Waktu pembuatan sekitar 3–5 menit (waktu pembuatan 4K sangat bergantung pada quality)
Praktis 2: Inpainting Mask (Forward + Gambar + Mask)
node scripts/generate_image.js \
-p "Replace the background with luxurious white marble countertop, \
soft natural window light from the left, \
keep product subject pixel-stable" \
-i "./coffee_cup.png" \
-m "./coffee_cup_mask.png" \
-s "2048x2048" \
-q "high" \
-f "./coffee_cup_marble.png"
- Piksel putih = latar belakang yang ingin diganti
- Piksel hitam = objek produk (piksel stabil)
- gpt-image-2 tidak akan merusak bentuk produk
Praktis 3: Draf Konsep Massal (Reverse + Loop)
# 100 konsep pakaian, $0,03 per gambar, total biaya sekitar $3
for i in $(seq 1 100); do
node scripts/generate_image.js \
-p "Desain karakter cyberpunk #${i}, hanfu modifikasi, nuansa neon, gambar seluruh tubuh" \
-r "url" \
-f "./concepts/concept_${i}.png"
done
- Skill Reverse mendukung petunjuk bahasa Indonesia dengan lebih stabil
- Dalam mode
-r url, skrip akan otomatis mengunduh ke lokal - Untuk skenario massal, disarankan menggunakan
APIYI_BASE_URL=https://vip.apiyi.com/v1
IV. Kombinasi Lanjutan OpenClaw dengan gpt-image-2
4.1 Membiarkan Agen Memilih Skill Secara Mandiri
Setelah menginstal Skill Forward dan Reverse, OpenClaw akan memilih secara otomatis berdasarkan bahasa Anda. Agar Agen memilih dengan lebih akurat, Anda bisa menyertakan sinyal petunjuk saat berbicara:
| Cara Anda Mengatakan | Agen Cenderung Memilih |
|---|---|
| "Kualitas tinggi", "4K", "Poster", "Foto komersial" | Forward apiyi-gpt-image-2-gen |
| "Sketsa", "Massal", "Draf konsep", "Bahasa Indonesia" | Reverse apiyi-gpt-image-2-all-gen |
| "Buatkan 10 dulu untuk dilihat" | Reverse (ekonomis) |
| "Ganti latar belakang pakai Mask" | Forward (Reverse tidak mendukung Mask) |
| "Tetap $0,03 per gambar" | Reverse |
🎯 Tips Petunjuk: Dengan menulis istilah seperti "kontrol presisi" atau "ekonomis massal" dalam kata kunci, OpenClaw hampir 100% akan memilih Skill yang tepat. Anda bisa menemukan lebih banyak contoh kata pemicu di kolom ekosistem Skills di
docs.apiyi.com.
4.2 Rantai Skill: Pembuatan Gambar → OCR → Terjemahan
Karena Skill dapat disusun secara bebas oleh Agen, integrasi OpenClaw dengan gpt-image-2 dapat dirangkai menjadi alur kerja multi-langkah. Contoh: "Buatkan poster dengan slogan bahasa Inggris, lalu terjemahkan slogan tersebut ke versi bahasa Jepang":
Pengguna: Buatkan poster minimalis dengan slogan bahasa Inggris "Less is more",
lalu buat versi dengan gambar yang sama namun slogan diganti ke bahasa Jepang
OpenClaw:
Step 1: apiyi-gpt-image-2-gen (versi Inggris)
→ ./en_poster.png
Step 2: apiyi-gpt-image-2-gen (versi Jepang, menggunakan en_poster.png sebagai gambar referensi)
-i ./en_poster.png
-p "Same layout, replace text with 'より少なく、より豊かに'"
→ ./jp_poster.png
Inilah kekuatan terbesar dari ekosistem Skill: Satu Skill melakukan satu hal, Agen bertanggung jawab menyusunnya menjadi alur kerja dengan kompleksitas apa pun.
4.3 Mengemas Skill ke dalam CI/CD
Skrip dari kedua Skill pada dasarnya adalah CLI standar, yang berarti keduanya dapat masuk ke dalam CI/CD dengan mulus:
# .github/workflows/generate-og-image.yml
name: Generate OG image on release
on:
release:
types: [published]
jobs:
og-image:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with: { node-version: '20' }
- run: npx skills add https://github.com/wuchubuzai2018/expert-skills-hub --skill apiyi-gpt-image-2-gen
- env:
APIYI_API_KEY: ${{ secrets.APIYI_API_KEY }}
run: |
node ~/.openclaw/skills/apiyi-gpt-image-2-gen/scripts/generate_image.js \
-p "Release ${{ github.event.release.tag_name }} cover image" \
-s "1200x630" \
-q "high" \
-f "./og-image.png"
- uses: actions/upload-artifact@v4
with: { name: og-image, path: ./og-image.png }
Setiap kali melakukan rilis, gambar OG akan dibuat secara otomatis. Agen dan CI berbagi satu set definisi Skill yang sama.
4.4 Penggunaan Kembali di Claude Code dan Cursor
Meskipun artikel ini berfokus pada OpenClaw, kedua Skill apiyi-gpt-image-2-gen / apiyi-gpt-image-2-all-gen sepenuhnya mematuhi standar Skills umum, sehingga:
| Klien | Apakah Didukung | Catatan |
|---|---|---|
| OpenClaw | ✅ | Skenario utama artikel ini |
| Claude Code | ✅ | Cukup letakkan di ~/.claude/skills/ |
| Cursor | ✅ | Referensi melalui file Rules |
| Windsurf | ✅ | Kompatibel dengan spesifikasi Skill |
| Agen Mandiri (LangChain, dll.) | ⚠️ | Perlu membungkus satu lapisan Tool Adapter |
"Instal sekali, gunakan kembali di banyak klien" memungkinkan kemampuan pembuatan gambar Anda berpindah mengikuti alat utama Anda tanpa perlu menulis ulang setiap saat.
V. FAQ Integrasi OpenClaw dengan gpt-image-2
Q1: npx skills add muncul pesan "command not found"?
Pastikan OpenClaw sudah diperbarui ke versi terbaru (openclaw update), karena versi lama tidak memiliki Skills CLI. Jika masih error, Anda bisa melakukan kloning repositori secara manual ke direktori ~/.openclaw/skills/ sebagai langkah cadangan.
Q2: Menjalankan skrip muncul pesan "APIYI_API_KEY is not set"?
Cek tiga hal berikut:
- Jalankan
echo $APIYI_API_KEYuntuk memastikan variabel berhasil diekspor. - Pastikan kunci API memiliki awalan
sk-. - Jika baru saja ditambahkan ke
~/.zshrc, buka terminal baru agar perubahannya berlaku.
Q3: Bagaimana cara mengalihkan pemanggilan ke jalur konkurensi tinggi vip.apiyi.com?
Ada dua cara:
# Cara 1: Variabel lingkungan global
export APIYI_BASE_URL="https://vip.apiyi.com/v1"
# Cara 2: Awalan saat pemanggilan tunggal
APIYI_BASE_URL="https://vip.apiyi.com/v1" node scripts/generate_image.js ...
Hal yang sama berlaku untuk domain cadangan: b.apiyi.com. Ketiga domain tersebut menggunakan kunci API yang sama. Jika situs utama mengalami gangguan, beralihlah secara manual ke VIP untuk pemulihan instan. Untuk strategi detail, silakan merujuk ke panduan pengalihan jalur di dokumentasi resmi APIYI docs.apiyi.com.
Q4: Pilih yang mana antara "reverse" (反转) dan "forward" (正转)?
Lihat tabel keputusan ini:
| Jika Anda membutuhkan… | Pilih |
|---|---|
Kontrol resolusi presisi (misalnya 1920x1080) |
Forward |
| Menggunakan Mask untuk inpainting lokal | Forward |
| Poster kualitas tinggi di atas 4K | Forward |
| Pemrosesan batch 50+ gambar | Reverse |
| Prompt bahasa Mandarin yang dominan | Reverse |
| Biaya yang dapat diprediksi ($0.03/gambar) | Reverse |
Cara paling praktis: Instal keduanya, biarkan Agen OpenClaw memilih secara otomatis berdasarkan bahasa alami Anda.
Q5: Apakah bisa digunakan di Claude Code?
Bisa. Cukup buat soft link atau salin paket Skill dari ~/.openclaw/skills/ ke ~/.claude/skills/. Claude Code akan secara otomatis mengenali SKILL.md dan mendaftarkannya sebagai alat yang dapat dipanggil. Kunci APIYI_API_KEY yang digunakan sama.
Q6: Apakah Skill aman?
Ekosistem Skill komunitas perlu diwaspadai. Pada Februari 2026, dilaporkan ada 341 Skill berbahaya yang menyebarkan malware Atomic Stealer melalui ClawHub. Saran kami:
- Hanya instal Skill dari repositori tepercaya (
wuchubuzai2018/expert-skills-hubdalam artikel ini adalah sumber resmi APIYI). - Setelah instalasi, periksa
SKILL.mddan konten skripnya, terutama perhatikan perintahcurl | bashatau kode yang menghubungkan ke domain asing. - Gunakan
npx skills inspect <nama-skill>untuk melihat alamat jaringan apa saja yang diakses oleh Skill tersebut.
Semua permintaan dari Skill resmi APIYI hanya ditujukan ke *.apiyi.com, sehingga aman untuk diaudit.
Q7: Apa yang harus dilakukan jika pembuatan gambar 4K lambat?
- Itu hal yang wajar.
quality=high+3840x2160membutuhkan waktu sekitar 3–5 menit. - Tambahkan perlindungan timeout di luar skrip (dalam Bash gunakan
timeout 360 node ...). - Jika butuh pratinjau cepat, gunakan
size=2048x1152 quality=mediumuntuk membuat draf terlebih dahulu, baru tingkatkan ke 4K setelah hasilnya sesuai.
Q8: Bagaimana cara memantau biaya?
Aktifkan fitur "Peringatan Anggaran Harian" dan "Statistik per Kunci API" di dasbor APIYI apiyi.com. Tetapkan batas anggaran khusus untuk kunci API yang digunakan OpenClaw agar Anda bisa memantau konsumsi dan segera menghentikan penggunaan jika terjadi hal yang tidak diinginkan.
VI. Kesimpulan Integrasi OpenClaw dengan gpt-image-2
Jika kita menengok kembali, jalur terbaik untuk integrasi OpenClaw dengan gpt-image-2 di tahun 2026 telah beralih dari "menulis kode" menjadi "menginstal Skill". Alasannya sederhana:
- Lebih cepat:
npx skills add+export KEY, selesai dalam 30 detik. - Lebih stabil: Detail HTTP, strategi percobaan ulang (retry), dan validasi parameter sudah terbungkus dalam Skill; pembaruan mengikuti pengembang Skill.
- Lebih luas: Skill yang sama dapat digunakan di OpenClaw, Claude Code, dan Cursor.
- Lebih cerdas: Agen dapat memahami
SKILL.mddan memutuskan sendiri kapan serta Skill mana yang harus digunakan.
Dua Skill yang disediakan APIYI, yaitu apiyi-gpt-image-2-gen (kontrol presisi) dan apiyi-gpt-image-2-all-gen (batch ekonomis), mencakup dua skenario paling umum. Menginstal keduanya sekaligus adalah titik awal yang paling praktis—baik untuk poster 4K maupun 100 draf konsep, Agen OpenClaw akan memilih Skill yang tepat secara otomatis.
🎯 Saran Implementasi: Ajukan kunci API pengujian di APIYI
apiyi.com(disarankan menetapkan batas harian ¥20–50), jalankan contoh minimal sesuai langkah ke-5 di §2; setelah alur dipastikan lancar, coba buat poster 4K dan inpainting Mask sesuai perintah di §3; jika terjadi gangguan jalur, segera alihkanAPIYI_BASE_URLkevip.apiyi.comataub.apiyi.com. Untuk kombinasi Skill yang lebih kompleks atau contoh CI/CD, silakan periksa kolom ekosistem Skills di dokumentasi resmi APIYIdocs.apiyi.com.
Dengan ini, Anda telah memiliki solusi integrasi OpenClaw gpt-image-2 yang lengkap dan dapat digunakan kembali di berbagai klien. Satu-satunya hal yang perlu Anda lakukan selanjutnya adalah menghapus tugas "menulis alat pemanggilan gambar" dari daftar tugas Anda selamanya—biarkan Skill yang menanganinya.
Penulis: Tim Teknis APIYI
Sumber Daya Terkait:
- Repositori Skills: github.com/wuchubuzai2018/expert-skills-hub
- Beranda OpenClaw: github.com/openclaw/openclaw
- Situs Resmi APIYI: apiyi.com
- Dokumentasi APIYI: docs.apiyi.com
- Situs Utama APIYI: api.apiyi.com (cadangan vip.apiyi.com / b.apiyi.com)
