Pembuatan Gambar
Tool image_generate memungkinkan agen membuat dan mengedit gambar menggunakan penyedia yang telah Anda konfigurasi. Gambar yang dihasilkan dikirim secara otomatis sebagai lampiran media dalam balasan agen.
Tool ini hanya muncul ketika setidaknya satu penyedia pembuatan gambar tersedia. Jika Anda tidak melihat image_generate dalam tools agen Anda, konfigurasi agents.defaults.imageGenerationModel atau siapkan API key penyedia.
Mulai cepat
- Setel API key untuk setidaknya satu penyedia (misalnya
OPENAI_API_KEY atau GEMINI_API_KEY).
- Opsional, setel model pilihan Anda:
{
agents: {
defaults: {
imageGenerationModel: "openai/gpt-image-1",
},
},
}
- Minta agen: “Buat gambar maskot lobster yang ramah.”
Agen akan memanggil image_generate secara otomatis. Tidak perlu allow-list tool — tool ini aktif secara default ketika penyedia tersedia.
Penyedia yang didukung
| Penyedia | Model default | Dukungan edit | API key |
|---|
| OpenAI | gpt-image-1 | Ya (hingga 5 gambar) | OPENAI_API_KEY |
| Google | gemini-3.1-flash-image-preview | Ya | GEMINI_API_KEY atau GOOGLE_API_KEY |
| fal | fal-ai/flux/dev | Ya | FAL_KEY |
| MiniMax | image-01 | Ya (referensi subjek) | MINIMAX_API_KEY atau OAuth MiniMax (minimax-portal) |
action: "list" untuk memeriksa penyedia dan model yang tersedia saat runtime:
/tool image_generate action=list
| Parameter | Tipe | Deskripsi |
|---|
prompt | string | Prompt pembuatan gambar (wajib untuk action: "generate") |
action | string | "generate" (default) atau "list" untuk memeriksa penyedia |
model | string | Penimpaan penyedia/model, misalnya openai/gpt-image-1 |
image | string | Jalur atau URL gambar referensi tunggal untuk mode edit |
images | string[] | Beberapa gambar referensi untuk mode edit (hingga 5) |
size | string | Petunjuk ukuran: 1024x1024, 1536x1024, 1024x1536, 1024x1792, 1792x1024 |
aspectRatio | string | Rasio aspek: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 |
resolution | string | Petunjuk resolusi: 1K, 2K, atau 4K |
count | number | Jumlah gambar yang akan dibuat (1–4) |
filename | string | Petunjuk nama file output |
Konfigurasi
Pemilihan model
{
agents: {
defaults: {
// Bentuk string: hanya model utama
imageGenerationModel: "google/gemini-3.1-flash-image-preview",
// Bentuk objek: utama + fallback berurutan
imageGenerationModel: {
primary: "openai/gpt-image-1",
fallbacks: ["google/gemini-3.1-flash-image-preview", "fal/fal-ai/flux/dev"],
},
},
},
}
Urutan pemilihan penyedia
Saat membuat gambar, OpenClaw mencoba penyedia dalam urutan ini:
- Parameter
model dari pemanggilan tool (jika agen menentukannya)
imageGenerationModel.primary dari konfigurasiimageGenerationModel.fallbacks secara berurutan- Deteksi otomatis — hanya menggunakan default penyedia yang didukung auth:
- penyedia default saat ini terlebih dahulu
- penyedia pembuatan gambar terdaftar lainnya yang tersisa dalam urutan provider-id
Jika suatu penyedia gagal (error auth, rate limit, dan sebagainya), kandidat berikutnya akan dicoba secara otomatis. Jika semuanya gagal, error akan menyertakan detail dari setiap percobaan.
Catatan:
- Deteksi otomatis bersifat sadar-auth. Default penyedia hanya masuk ke daftar kandidat
ketika OpenClaw benar-benar dapat mengautentikasi penyedia tersebut.
- Gunakan
action: "list" untuk memeriksa penyedia yang saat ini terdaftar, model
defaultnya, dan petunjuk env var auth.
Pengeditan gambar
OpenAI, Google, fal, dan MiniMax mendukung pengeditan gambar referensi. Teruskan jalur atau URL gambar referensi:
"Buat versi cat air dari foto ini" + image: "/path/to/photo.jpg"
images. fal dan MiniMax mendukung 1.
Pembuatan gambar MiniMax tersedia melalui kedua jalur auth MiniMax bawaan:
minimax/image-01 untuk penyiapan API keyminimax-portal/image-01 untuk penyiapan OAuth
Kemampuan penyedia
| Kemampuan | OpenAI | Google | fal | MiniMax |
|---|
| Membuat | Ya (hingga 4) | Ya (hingga 4) | Ya (hingga 4) | Ya (hingga 9) |
| Edit/referensi | Ya (hingga 5 gambar) | Ya (hingga 5 gambar) | Ya (1 gambar) | Ya (1 gambar, ref subjek) |
| Kontrol ukuran | Ya | Ya | Ya | Tidak |
| Rasio aspek | Tidak | Ya | Ya (hanya pembuatan) | Ya |
| Resolusi (1K/2K/4K) | Tidak | Ya | Ya | Tidak |
Terkait
