Görsel oluşturma

Çağrı başına model geçersiz kılması yalnızca belirtilen sağlayıcıyı/modeli dener; yapılandırılmış birincil/yedek veya otomatik algılanan sağlayıcılarla devam etmez.

Bir sağlayıcı varsayılanı, yalnızca OpenClaw gerçekten o sağlayıcıda kimlik doğrulaması yapabiliyorsa aday listesine girer. Yalnızca açıkça belirtilmiş model, primary ve fallbacks girdilerini kullanmak için agents.defaults.mediaGenerationAutoProviderFallback: false ayarını yapın.

Yavaş görüntü arka uçları için agents.defaults.imageGenerationModel.timeoutMs ayarını yapın. Çağrı başına timeoutMs araç parametresi yapılandırılmış varsayılanı, yapılandırılmış varsayılanlar ise Plugin tarafından tanımlanan sağlayıcı varsayılanlarını geçersiz kılar. Google ve OpenRouter tarafından barındırılan görüntü sağlayıcıları varsayılan olarak 180 saniye kullanır; Microsoft Foundry MAI, xAI ve Azure OpenAI görüntü oluşturma ise 600 saniye kullanır. Codex dinamik araç çağrıları, 120 saniyelik varsayılan bir image_generate köprüsü kullanır ve yapılandırıldığında aynı zaman aşımı bütçesine uyar; bu süre OpenClaw'ın 600000 ms'lik dinamik araç köprüsü üst sınırıyla sınırlıdır.

Şu anda kayıtlı sağlayıcıları, varsayılan modellerini ve kimlik doğrulama ortam değişkeni ipuçlarını incelemek için action: "list" kullanın.

OpenAI görüntü oluşturma varsayılan olarak openai/gpt-image-2 kullanır. Bir openai OAuth profili yapılandırılmışsa OpenClaw, Codex abonelik sohbet modellerinin kullandığı OAuth profilini yeniden kullanır ve görüntü isteğini Codex Responses arka ucu üzerinden gönderir. https://chatgpt.com/backend-api gibi eski Codex temel URL'leri, görüntü istekleri için https://chatgpt.com/backend-api/codex biçiminde standartlaştırılır. OpenClaw bu istek için sessizce OPENAI_API_KEY kullanımına geri dönmez; doğrudan OpenAI Images API yönlendirmesini zorlamak için models.providers.openai seçeneğini bir API anahtarı, özel temel URL veya Azure uç noktasıyla açıkça yapılandırın.

openai/gpt-image-1.5, openai/gpt-image-1 ve openai/gpt-image-1-mini modelleri yine açıkça seçilebilir. Şeffaf arka planlı PNG/WebP çıktısı için gpt-image-1.5 kullanın; mevcut gpt-image-2 API'si background: "transparent" değerini reddeder.

gpt-image-2, aynı image_generate aracı üzerinden hem metinden görüntü oluşturmayı hem de referans görüntü düzenlemeyi destekler. OpenClaw; prompt, count, size, quality, outputFormat ve referans görüntüleri OpenAI'a iletir. OpenAI, aspectRatio veya resolution değerlerini doğrudan almaz; mümkün olduğunda OpenClaw bunları desteklenen bir size değerine eşler, aksi takdirde araç bunları yok sayılan geçersiz kılmalar olarak bildirir.

OpenAI'a özgü seçenekler openai nesnesi altında bulunur:

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

openai.background; transparent, opaque veya auto değerlerini kabul eder. Şeffaf çıktılar için outputFormat değerinin png ya da webp olması ve şeffaflığı destekleyen bir OpenAI görüntü modeli kullanılması gerekir. OpenClaw, varsayılan gpt-image-2 şeffaf arka plan isteklerini gpt-image-1.5 modeline yönlendirir. openai.outputCompression JPEG/WebP çıktılarına uygulanır ve PNG çıktılarında yok sayılır.

Üst düzey background ipucu sağlayıcıdan bağımsızdır ve OpenAI sağlayıcısı seçildiğinde şu anda aynı OpenAI background istek alanına eşlenir. Arka plan desteği bildirmeyen sağlayıcılar, desteklenmeyen parametreyi almak yerine bunu ignoredOverrides içinde döndürür.

OpenAI görüntü oluşturmayı api.openai.com yerine bir Azure OpenAI dağıtımı üzerinden yönlendirmek için Azure OpenAI uç noktaları bölümüne bakın.

Microsoft Foundry görüntü oluşturma, microsoft-foundry/ sağlayıcı öneki altında dağıtılmış MAI görüntü dağıtımı adlarını kullanır. MAI API, dağıtım adınızı model alanında beklediğinden sağlayıcı düzeyinde varsayılan bir model yoktur:

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

Sağlayıcı, OpenAI Images API'yi değil Microsoft Foundry'nin MAI API'sini kullanır:

• Oluşturma uç noktası: /mai/v1/images/generations
• Düzenleme uç noktası: /mai/v1/images/edits
• Kimlik doğrulama: AZURE_OPENAI_API_KEY / sağlayıcı API anahtarı veya az login üzerinden Entra ID
• Çıktı: bir PNG görüntüsü
• Boyut: varsayılan 1024x1024; genişlik ve yüksekliğin her biri en az 768 px, toplam piksel sayısı ise en fazla 1.048.576 olmalıdır
• Düzenlemeler: bir PNG veya JPEG referans görüntüsü; yalnızca MAI-Image-2.5-Flash ve MAI-Image-2.5 dağıtımları tarafından desteklenir

Yalnızca istem kullanan oluşturma işlemi, sadece Foundry uç noktası yapılandırılarak özel bir dağıtım adı kullanabilir. Özel dağıtım adlarıyla yapılan düzenlemelerde OpenClaw'ın dağıtımın MAI-Image-2.5-Flash veya MAI-Image-2.5 tarafından desteklendiğini doğrulayabilmesi için ilk kullanım/model meta verileri gerekir.

Mevcut MAI görüntü modelleri MAI-Image-2.5-Flash, MAI-Image-2.5, MAI-Image-2e ve MAI-Image-2 modelleridir. Kurulum ve sohbet modeli davranışı için Microsoft Foundry Plugin bölümüne bakın.

OpenRouter görüntü oluşturma aynı OPENROUTER_API_KEY değerini kullanır ve OpenRouter'ın sohbet tamamlama görüntü API'si üzerinden yönlendirilir. OpenRouter görüntü modellerini openrouter/ önekiyle seçin:

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

OpenClaw; prompt, count, referans görüntüleri ve Gemini uyumlu aspectRatio / resolution ipuçlarını OpenRouter'a iletir. Mevcut yerleşik OpenRouter görüntü modeli kısayolları arasında google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview ve openai/gpt-5.4-image-2 bulunur. Yapılandırılmış Plugin'inizin neleri sunduğunu görmek için action: "list" kullanın.

fal üzerindeki Krea 2 modelleri, Flux'ın kullandığı genel image_size şeması yerine fal'ın yerel Krea şemasını kullanır. OpenClaw şunları gönderir:

• En-boy oranı ipuçları için aspect_ratio
• Varsayılan değeri medium olan creativity
• image veya images sağlandığında image_style_references

Daha hızlı ve etkileyici illüstrasyonlar için Krea 2 Medium'u; daha yavaş, daha ayrıntılı, fotogerçekçi ve dokulu görünümler için Krea 2 Large'ı seçin:

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

Krea 2 şu anda istek başına bir görüntü döndürür. Krea için aspectRatio kullanmayı tercih edin; OpenClaw, size değerini desteklenen en yakın Krea en-boy oranına eşler ve resolution değerini yok saymak yerine Krea için reddeder. Yerel bir Krea yaratıcılık düzeyi istediğinizde fal.creativity kullanın:

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

MiniMax görüntü oluşturma, paketle birlikte gelen her iki MiniMax kimlik doğrulama yolu üzerinden kullanılabilir:

• API anahtarı kurulumları için minimax/image-01
• OAuth kurulumları için minimax-portal/image-01

Paketle birlikte gelen xAI sağlayıcısı, yalnızca istem içeren istekler için /v1/images/generations; image veya images mevcut olduğunda ise /v1/images/edits kullanır.

• Modeller: xai/grok-imagine-image, xai/grok-imagine-image-quality
• Adet: en fazla 4
• Referanslar: bir image veya en fazla üç images
• En-boy oranları: 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
• Çözünürlükler: 1K, 2K
• Çıktılar: OpenClaw tarafından yönetilen görüntü ekleri olarak döndürülür

OpenClaw; bu denetimler sağlayıcılar arası ortak image_generate sözleşmesinde bulunana kadar xAI'a özgü quality, mask, user veya auto en-boy oranını bilinçli olarak kullanıma sunmaz.