Pembuatan gambar

Penggantian model per pemanggilan hanya mencoba penyedia/model tersebut dan tidak melanjutkan ke penyedia utama/cadangan terkonfigurasi atau penyedia yang terdeteksi otomatis.

Default 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 menggantikan default terkonfigurasi, dan default terkonfigurasi menggantikan default penyedia yang ditentukan 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 saat dikonfigurasi, dengan batas maksimum jembatan alat dinamis OpenClaw sebesar 600000 md.

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

Pembuatan gambar OpenAI menggunakan default openai/gpt-image-2. Jika profil OAuth openai dikonfigurasi, OpenClaw menggunakan kembali profil OAuth yang sama dengan yang digunakan oleh model percakapan langganan Codex dan mengirimkan 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 memaksa perutean langsung melalui OpenAI Images API, konfigurasikan models.providers.openai secara eksplisit dengan kunci API, URL dasar khusus, atau titik akhir Azure.

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

gpt-image-2 mendukung pembuatan teks-ke-gambar maupun penyuntingan 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 memetakan nilai tersebut ke size yang didukung. Jika tidak, alat akan melaporkannya sebagai penggantian 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 default gpt-image-2 dengan latar transparan ke gpt-image-1.5. openai.outputCompression berlaku untuk keluaran JPEG/WebP dan diabaikan untuk keluaran PNG.

Petunjuk background tingkat atas bersifat netral terhadap penyedia dan saat ini dipetakan ke bidang permintaan background OpenAI 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 sebagai pengganti api.openai.com, lihat titik akhir Azure OpenAI.

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

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

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

• Titik akhir pembuatan: /mai/v1/images/generations
• Titik akhir penyuntingan: /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 sekurang-kurangnya 768 px, dan jumlah total piksel tidak boleh melebihi 1.048.576
• Penyuntingan: satu gambar referensi PNG atau JPEG, hanya didukung oleh deployment MAI-Image-2.5-Flash dan MAI-Image-2.5

Pembuatan yang hanya menggunakan prompt dapat memakai nama deployment khusus dengan hanya titik akhir Foundry yang dikonfigurasi. Penyuntingan 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-preview, google/gemini-3-pro-image-preview, 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 mengirimkan:

• 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 terperinci:

{  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 menghapusnya. Gunakan fal.creativity ketika 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 berbasis kunci API
• minimax-portal/image-01 untuk penyiapan OAuth

Penyedia xAI bawaan menggunakan /v1/images/generations untuk permintaan yang hanya berisi prompt 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, atau rasio aspek auto native xAI hingga kontrol tersebut tersedia dalam kontrak lintas penyedia image_generate bersama.