Görsel oluşturma

Çağrı başına model geçersiz kılması yalnızca o sağlayıcı/modeli dener ve yapılandırılmış primary/fallback ya da otomatik algılanan sağlayıcılarla devam etmez.

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

Yavaş görüntü backend'leri için agents.defaults.imageGenerationModel.timeoutMs ayarlayın. Çağrı başına timeoutMs araç parametresi yapılandırılmış varsayılanı geçersiz kılar; yapılandırılmış varsayılanlar da Plugin tarafından yazılmış 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ı 180 saniyelik varsayılanlar kullanır; Microsoft Foundry MAI, xAI ve Azure OpenAI görüntü oluşturma 600 saniye kullanır. Codex dinamik araç çağrıları 120 saniyelik image_generate köprü varsayılanını kullanır ve yapılandırıldığında aynı zaman aşımı bütçesine uyar; OpenClaw'ın 600000 ms 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ı openai/gpt-image-2 şeklindedir. Bir openai OAuth profili yapılandırılmışsa, OpenClaw Codex abonelik sohbet modelleri tarafından kullanılan aynı OAuth profilini yeniden kullanır ve görüntü isteğini Codex Responses backend'i ü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çimine kanonikleştirilir. OpenClaw bu istek için sessizce OPENAI_API_KEY seçeneğine geri dönmez - doğrudan OpenAI Images API yönlendirmesini zorlamak için models.providers.openai değerini 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 hâlâ açıkça seçilebilir. Saydam 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ülerini OpenAI'ye 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 halde araç bunları yok sayılan geçersiz kılmalar olarak bildirir.

OpenAI'ye özgü seçenekler openai nesnesinin altında bulunur:

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

openai.background transparent, opaque veya auto kabul eder; saydam çıktılar için outputFormat değerinin png veya webp olması ve saydamlık özellikli bir OpenAI görüntü modeli gerekir. OpenClaw, varsayılan gpt-image-2 saydam arka plan isteklerini gpt-image-1.5 modeline yönlendirir. openai.outputCompression JPEG/WebP çıktılarına uygulanır ve PNG çıktıları için 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. Sağlayıcı düzeyinde varsayılan model yoktur, çünkü MAI API'si dağıtım adınızı model alanında bekler:

{  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ükseklik ayrı ayrı en az 768 px olmalı, toplam piksel sayısı en fazla 1.048.576 olmalıdır
• Düzenlemeler: yalnızca MAI-Image-2.5-Flash ve MAI-Image-2.5 dağıtımları tarafından desteklenen bir PNG veya JPEG referans görüntüsü

Yalnızca istemli oluşturma, sadece Foundry uç noktası yapılandırılmış olarak özel bir dağıtım adı kullanabilir. Özel dağıtım adlarıyla yapılan düzenlemeler, OpenClaw'ın dağıtımın MAI-Image-2.5-Flash veya MAI-Image-2.5 tarafından desteklendiğini doğrulayabilmesi için onboarding/model meta verisine ihtiyaç duyar.

Geçerli MAI görüntü modelleri MAI-Image-2.5-Flash, MAI-Image-2.5, MAI-Image-2e ve MAI-Image-2 şeklindedir. 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ülerini 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 ne sunduğunu görmek için action: "list" kullanın.

fal üzerindeki Krea 2 modelleri, Flux tarafından kullanılan 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ı medium olan creativity
• image veya images sağlandığında image_style_references

Daha hızlı, ifadeli illüstrasyon 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 tercih edin; OpenClaw size değerini en yakın desteklenen Krea en-boy oranına eşler ve Krea için resolution değerini sessizce atmak yerine reddeder. Yerel 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, iki yerleşik MiniMax kimlik doğrulama yolu üzerinden kullanılabilir:

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

Yerleşik xAI sağlayıcısı, yalnızca istemli istekler için /v1/images/generations, image veya images bulunduğunda /v1/images/edits kullanır.

• Modeller: xai/grok-imagine-image, xai/grok-imagine-image-quality
• Sayı: en fazla 4
• Referanslar: bir image veya en fazla beş images
• En-boy oranları: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Çö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 paylaşılan sağlayıcılar arası image_generate sözleşmesinde var olana kadar xAI'ye özgü quality, mask, user veya ek yerel-only en-boy oranlarını özellikle açığa çıkarmaz.