Pembuatan gambar

Penimpaan model per panggilan hanya mencoba penyedia/model tersebut dan tidak berlanjut ke penyedia utama/cadangan terkonfigurasi atau penyedia yang terdeteksi otomatis.

Default penyedia hanya masuk ke daftar kandidat ketika OpenClaw dapat benar-benar mengautentikasi penyedia tersebut. Tetapkan agents.defaults.mediaGenerationAutoProviderFallback: false untuk hanya menggunakan entri model, primary, dan fallbacks eksplisit.

Tetapkan agents.defaults.imageGenerationModel.timeoutMs untuk backend gambar yang lambat. Parameter alat timeoutMs per panggilan menimpa default terkonfigurasi, dan default terkonfigurasi menimpa default penyedia yang dibuat Plugin. Penyedia gambar yang dihosting Google dan OpenRouter menggunakan default 180 detik; pembuatan gambar Microsoft Foundry MAI, xAI, dan Azure OpenAI menggunakan 600 detik. Panggilan alat dinamis Codex menggunakan default bridge image_generate 120 detik dan menghormati anggaran batas waktu yang sama ketika dikonfigurasi, dibatasi oleh maksimum bridge alat dinamis OpenClaw sebesar 600000 ms.

Gunakan action: "list" untuk memeriksa penyedia yang saat ini terdaftar, model defaultnya, dan petunjuk env-var autentikasi.

Pembuatan gambar OpenAI secara default menggunakan openai/gpt-image-2. Jika profil OAuth openai dikonfigurasi, OpenClaw menggunakan kembali profil OAuth yang sama yang digunakan oleh model chat langganan Codex dan mengirim permintaan gambar melalui backend Codex Responses. URL basis Codex lama seperti https://chatgpt.com/backend-api dikanonisasi menjadi https://chatgpt.com/backend-api/codex untuk permintaan gambar. OpenClaw tidak diam-diam beralih ke OPENAI_API_KEY untuk permintaan tersebut - untuk memaksa perutean langsung OpenAI Images API, konfigurasikan models.providers.openai secara eksplisit dengan kunci API, URL basis khusus, atau endpoint Azure.

Model openai/gpt-image-1.5, openai/gpt-image-1, dan openai/gpt-image-1-mini masih dapat dipilih secara eksplisit. Gunakan gpt-image-1.5 untuk output PNG/WebP berlatar transparan; API gpt-image-2 saat ini menolak background: "transparent".

gpt-image-2 mendukung pembuatan teks-ke-gambar dan pengeditan gambar referensi melalui alat image_generate yang sama. OpenClaw meneruskan prompt, count, size, quality, outputFormat, dan gambar referensi ke OpenAI. OpenAI tidak menerima aspectRatio atau resolution secara langsung; bila memungkinkan OpenClaw memetakan keduanya ke size yang didukung, jika tidak alat melaporkannya sebagai penimpaan yang diabaikan.

Opsi khusus OpenAI berada di bawah objek openai:

{  "quality": "low",  "outputFormat": "jpeg",  "openai": {    "background": "opaque",    "moderation": "low",    "outputCompression": 60,    "user": "end-user-42"  }}

openai.background menerima transparent, opaque, atau auto; output transparan memerlukan outputFormat png atau webp dan model gambar OpenAI yang mendukung transparansi. OpenClaw merutekan permintaan berlatar transparan gpt-image-2 default ke gpt-image-1.5. openai.outputCompression berlaku untuk output JPEG/WebP dan diabaikan untuk output PNG.

Petunjuk background tingkat atas bersifat netral penyedia dan saat ini dipetakan ke bidang permintaan background OpenAI yang sama ketika penyedia OpenAI dipilih. Penyedia yang tidak mendeklarasikan dukungan latar mengembalikannya di ignoredOverrides, bukan menerima parameter yang tidak didukung tersebut.

Untuk merutekan pembuatan gambar OpenAI melalui deployment Azure OpenAI alih-alih api.openai.com, lihat endpoint Azure OpenAI.

Pembuatan gambar Microsoft Foundry menggunakan nama deployment gambar MAI yang dideploy di bawah prefiks penyedia microsoft-foundry/. Tidak ada model default tingkat penyedia karena MAI API mengharapkan nama deployment Anda di bidang model:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "microsoft-foundry/<deployment-name>",        timeoutMs: 600_000,      },    },  },}

Penyedia menggunakan MAI API Microsoft Foundry, bukan OpenAI Images API:

• Endpoint pembuatan: /mai/v1/images/generations
• Endpoint edit: /mai/v1/images/edits
• Autentikasi: AZURE_OPENAI_API_KEY / kunci API penyedia, atau Entra ID melalui az login
• Output: satu gambar PNG
• Ukuran: default 1024x1024; lebar dan tinggi masing-masing harus setidaknya 768 px, dan total piksel harus paling banyak 1.048.576
• Edit: satu gambar referensi PNG atau JPEG, hanya didukung oleh deployment MAI-Image-2.5-Flash dan MAI-Image-2.5

Pembuatan hanya dari prompt dapat menggunakan nama deployment khusus hanya dengan endpoint Foundry yang dikonfigurasi. Edit dengan nama deployment khusus membutuhkan metadata onboarding/model agar OpenClaw dapat memverifikasi bahwa deployment tersebut didukung oleh MAI-Image-2.5-Flash atau MAI-Image-2.5.

Model gambar MAI saat ini adalah MAI-Image-2.5-Flash, MAI-Image-2.5, MAI-Image-2e, dan MAI-Image-2. Lihat Plugin Microsoft Foundry untuk penyiapan dan perilaku model chat.

Pembuatan gambar OpenRouter menggunakan OPENROUTER_API_KEY yang sama dan dirutekan melalui API gambar chat completions OpenRouter. Pilih model gambar OpenRouter dengan prefiks openrouter/:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "openrouter/google/gemini-3.1-flash-image-preview",      },    },  },}

OpenClaw meneruskan prompt, count, gambar referensi, dan petunjuk aspectRatio / resolution yang kompatibel dengan Gemini ke OpenRouter. Pintasan model gambar OpenRouter bawaan saat ini mencakup google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview, dan openai/gpt-5.4-image-2. Gunakan action: "list" untuk melihat apa yang diekspos Plugin terkonfigurasi Anda.

Model Krea 2 di fal menggunakan skema Krea native milik fal, bukan skema image_size generik yang digunakan oleh Flux. OpenClaw mengirim:

• aspect_ratio untuk petunjuk rasio aspek
• creativity, dengan default medium
• image_style_references saat image atau images disediakan

Pilih Krea 2 Medium untuk ilustrasi ekspresif yang lebih cepat dan Krea 2 Large untuk tampilan fotorealistik dan bertekstur yang lebih lambat serta lebih detail:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/krea/v2/medium/text-to-image",      },    },  },}

Krea 2 saat ini mengembalikan satu gambar per permintaan. Utamakan aspectRatio untuk Krea; OpenClaw memetakan size ke rasio aspek Krea terdekat yang didukung dan menolak resolution untuk Krea alih-alih mengabaikannya. Gunakan fal.creativity saat Anda menginginkan tingkat kreativitas native Krea:

{  "model": "fal/krea/v2/medium/text-to-image",  "prompt": "A cyber zine portrait with risograph texture",  "aspectRatio": "9:16",  "fal": {    "creativity": "high"  }}

Pembuatan gambar MiniMax tersedia melalui kedua jalur autentikasi MiniMax bawaan:

• minimax/image-01 untuk penyiapan kunci API
• minimax-portal/image-01 untuk penyiapan OAuth

Penyedia xAI bawaan menggunakan /v1/images/generations untuk permintaan hanya prompt dan /v1/images/edits saat image atau images ada.

• Model: xai/grok-imagine-image, xai/grok-imagine-image-quality
• Jumlah: hingga 4
• Referensi: satu image atau hingga lima images
• Rasio aspek: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Resolusi: 1K, 2K
• Output: dikembalikan sebagai lampiran gambar yang dikelola OpenClaw

OpenClaw dengan sengaja tidak mengekspos quality, mask, user, atau rasio aspek tambahan yang hanya native xAI hingga kontrol tersebut ada dalam kontrak image_generate lintas penyedia bersama.