Görsel oluşturma

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

Bir sağlayıcı varsayılanı, yalnızca OpenClaw ilgili sağlayıcıda gerçekten kimlik doğrulaması yapabiliyorsa aday listesine girer. Kimliği doğrulanmış sağlayıcılar arasında otomatik yedekleme her zaman etkindir; çağrı başına model belirleyici olmaya devam eder.

Yavaş görüntü arka uçları için agents.defaults.mediaModels.image.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 ise 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; bu süre 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ı, bunların 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ığı aynı 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çimine standartlaştırılır. 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 öğesini 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 de açıkça seçilebilir. Şeffaf arka planlı PNG/WebP çıktısı için gpt-image-1.5 kullanın; geçerli 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üsü düzenlemeyi destekler. OpenClaw; prompt, count, size, quality, outputFormat ve referans görüntülerini 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 durumda 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 kabul eder; şeffaf çıktılar için outputFormat değerinin png veya webp olması ve şeffaflığı destekleyen bir OpenAI görüntü modeli 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ı 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. MAI API, dağıtım adınızı model alanında beklediğinden sağlayıcı düzeyinde varsayılan 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 olmalı, toplam piksel sayısı ise 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 istemle oluşturma, sadece Foundry uç noktası yapılandırılmışken ö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 katılım/model meta verileri gerekir.

Geçerli 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 öğesini 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. Geçerli yerleşik OpenRouter görüntü modeli kısayolları arasında google/gemini-3.1-flash-image, google/gemini-3-pro-image 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 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 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 tercih edin; OpenClaw, size değerini desteklenen en yakın Krea en-boy oranına eşler ve kaldırmak yerine Krea için resolution değerini 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": "Risograf dokulu bir siber fanzin portresi",  "aspectRatio": "9:16",  "fal": {    "creativity": "high"  }}

MiniMax görüntü oluşturma, paketlenmiş MiniMax kimlik doğrulama yollarının ikisi üzerinden de kullanılabilir:

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

Paketlenmiş 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
• Sayı: 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ı kasıtlı olarak kullanıma sunmaz.