Görsel oluşturma

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

Bir sağlayıcı varsayılanı, aday listesine yalnızca OpenClaw gerçekten o sağlayıcıda 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örsel arka uçları 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.

Geçerli 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örsel oluşturma varsayılan olarak openai/gpt-image-2 kullanır. Bir openai-codex OAuth profili yapılandırılmışsa OpenClaw, Codex abonelik sohbet modelleri tarafından kullanılan aynı OAuth profilini yeniden kullanır ve görsel isteğini Codex Responses arka ucu üzerinden gönderir. https://chatgpt.com/backend-api gibi eski Codex temel URL'leri, görsel 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 kullanımına 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 yine de 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örsel oluşturmayı hem de referans görselle düzenlemeyi destekler. OpenClaw, prompt, count, size, quality, outputFormat ve referans görselleri 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 yer alır:

{
  "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 olarak png veya webp ve şeffaflığı destekleyen bir OpenAI görsel 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ı için geçerlidir.

Ü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örsel 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.

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

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

OpenClaw, prompt, count, referans görseller ve Gemini uyumlu aspectRatio / resolution ipuçlarını OpenRouter'a iletir. Mevcut yerleşik OpenRouter görsel 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 tarafından nelerin sunulduğunu görmek için action: "list" kullanın.

MiniMax görsel 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 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-pro
• Sayı: 4'e kadar
• Referanslar: bir image veya beşe kadar 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örsel ekleri olarak döndürülür

OpenClaw, bu denetimler paylaşılan sağlayıcılar arası image_generate sözleşmesinde bulunana kadar xAI'ye özgü quality, mask, user veya yalnızca yerel ekstra en-boy oranlarını bilerek kullanıma sunmaz.