Pembuatan gambar

Penimpaan model per pemanggilan hanya mencoba penyedia/model tersebut dan tidak melanjutkan ke penyedia utama/cadangan yang dikonfigurasi maupun penyedia yang terdeteksi otomatis.

Default suatu penyedia hanya dimasukkan ke daftar kandidat ketika OpenClaw benar-benar dapat mengautentikasi penyedia tersebut. Atur agents.defaults.mediaGenerationAutoProviderFallback: false agar hanya menggunakan entri model, primary, dan fallbacks yang eksplisit.

Atur agents.defaults.imageGenerationModel.timeoutMs untuk backend gambar yang lambat. Parameter alat timeoutMs per pemanggilan menimpa default yang dikonfigurasi, dan default yang dikonfigurasi menimpa default penyedia yang ditentukan oleh plugin. Penyedia gambar yang dihosting Google dan OpenRouter menggunakan default 180 detik; pembuatan gambar Microsoft Foundry MAI, xAI, dan Azure OpenAI menggunakan 600 detik. Pemanggilan alat dinamis Codex menggunakan default jembatan image_generate selama 120 detik dan mematuhi anggaran batas waktu yang sama ketika dikonfigurasi, dibatasi oleh batas maksimum jembatan alat dinamis OpenClaw sebesar 600000 ms.

Gunakan action: "list" untuk memeriksa penyedia yang saat ini terdaftar, model defaultnya, dan petunjuk variabel lingkungan autentikasi.

Pembuatan gambar OpenAI menggunakan openai/gpt-image-2 secara default. Jika profil OAuth openai dikonfigurasi, OpenClaw menggunakan kembali profil OAuth yang sama dengan yang digunakan oleh model percakapan langganan Codex dan mengirim permintaan gambar melalui backend Codex Responses. URL dasar Codex lama seperti https://chatgpt.com/backend-api dikanonisasi menjadi https://chatgpt.com/backend-api/codex untuk permintaan gambar. OpenClaw tidak secara diam-diam beralih ke OPENAI_API_KEY untuk permintaan tersebut - untuk memaksakan perutean langsung melalui OpenAI Images API, konfigurasikan models.providers.openai secara eksplisit dengan kunci API, URL dasar 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 keluaran PNG/WebP dengan latar belakang 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; jika memungkinkan, OpenClaw memetakannya 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; keluaran transparan memerlukan outputFormat png atau webp serta model gambar OpenAI yang mendukung transparansi. OpenClaw merutekan permintaan latar belakang transparan gpt-image-2 default ke gpt-image-1.5. openai.outputCompression berlaku untuk keluaran JPEG/WebP dan diabaikan untuk keluaran PNG.

Petunjuk tingkat atas background bersifat netral terhadap penyedia dan saat ini dipetakan ke kolom permintaan OpenAI background yang sama ketika penyedia OpenAI dipilih. Penyedia yang tidak menyatakan dukungan latar belakang mengembalikannya dalam ignoredOverrides, alih-alih menerima parameter yang tidak didukung.

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

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

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

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

• Endpoint pembuatan: /mai/v1/images/generations
• Endpoint pengeditan: /mai/v1/images/edits
• Autentikasi: AZURE_OPENAI_API_KEY / kunci API penyedia, atau Entra ID melalui az login
• Keluaran: satu gambar PNG
• Ukuran: default 1024x1024; lebar dan tinggi masing-masing harus sedikitnya 768 px, dan jumlah piksel keseluruhan tidak boleh melebihi 1,048,576
• Pengeditan: satu gambar referensi PNG atau JPEG, hanya didukung oleh deployment MAI-Image-2.5-Flash dan MAI-Image-2.5

Pembuatan hanya dengan perintah dapat menggunakan nama deployment khusus hanya dengan endpoint Foundry yang dikonfigurasi. Pengeditan dengan nama deployment khusus memerlukan metadata orientasi awal/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 percakapan.

Pembuatan gambar OpenRouter menggunakan OPENROUTER_API_KEY yang sama dan dirutekan melalui API gambar penyelesaian percakapan 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, serta petunjuk aspectRatio / resolution yang kompatibel dengan Gemini ke OpenRouter. Pintasan model gambar OpenRouter bawaan saat ini mencakup google/gemini-3.1-flash-image, google/gemini-3-pro-image, dan openai/gpt-5.4-image-2. Gunakan action: "list" untuk melihat apa yang diekspos oleh plugin terkonfigurasi Anda.

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

• aspect_ratio untuk petunjuk rasio aspek
• creativity, dengan default medium
• image_style_references ketika image atau images diberikan

Pilih Krea 2 Medium untuk ilustrasi ekspresif yang lebih cepat dan Krea 2 Large untuk tampilan fotorealistis dan bertekstur yang lebih lambat tetapi lebih mendetail:

{  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 ketika Anda menginginkan tingkat kreativitas native Krea:

{  "model": "fal/krea/v2/medium/text-to-image",  "prompt": "Potret zine siber dengan tekstur risograf",  "aspectRatio": "9:16",  "fal": {    "creativity": "high"  }}

Pembuatan gambar MiniMax tersedia melalui kedua jalur autentikasi MiniMax bawaan:

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

Penyedia xAI bawaan menggunakan /v1/images/generations untuk permintaan hanya dengan perintah dan /v1/images/edits ketika terdapat image atau images.

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

OpenClaw sengaja tidak mengekspos quality, mask, user native xAI, maupun rasio aspek auto hingga kontrol tersebut tersedia dalam kontrak lintas penyedia bersama image_generate.