Генерація зображень

Перевизначення model для окремого виклику пробує лише цього провайдера/модель і не переходить до налаштованих primary/fallback або автовиявлених провайдерів.

Значення провайдера за замовчуванням потрапляє до списку кандидатів лише тоді, коли OpenClaw може фактично автентифікувати цього провайдера. Задайте agents.defaults.mediaGenerationAutoProviderFallback: false, щоб використовувати лише явні записи model, primary і fallbacks.

Задайте agents.defaults.imageGenerationModel.timeoutMs для повільних бекендів зображень. Параметр інструмента timeoutMs для окремого виклику перевизначає налаштоване значення за замовчуванням.

Використовуйте action: "list", щоб переглянути поточно зареєстрованих провайдерів, їхні моделі за замовчуванням і підказки env-var для автентифікації.

Генерація зображень OpenAI за замовчуванням використовує openai/gpt-image-2. Якщо налаштовано OAuth-профіль openai-codex, OpenClaw повторно використовує той самий OAuth-профіль, який застосовується чат-моделями підписки Codex, і надсилає запит зображення через бекенд Codex Responses. Застарілі базові URL-адреси Codex, як-от https://chatgpt.com/backend-api, канонізуються до https://chatgpt.com/backend-api/codex для запитів зображень. OpenClaw не виконує непомітний відкат до OPENAI_API_KEY для цього запиту - щоб примусово спрямувати маршрутизацію напряму через OpenAI Images API, налаштуйте models.providers.openai явно з API-ключем, власною базовою URL-адресою або кінцевою точкою Azure.

Моделі openai/gpt-image-1.5, openai/gpt-image-1 і openai/gpt-image-1-mini все ще можна вибрати явно. Використовуйте gpt-image-1.5 для виводу PNG/WebP із прозорим фоном; поточний API gpt-image-2 відхиляє background: "transparent".

gpt-image-2 підтримує як генерацію зображення з тексту, так і редагування за референсним зображенням через той самий інструмент image_generate. OpenClaw пересилає prompt, count, size, quality, outputFormat і референсні зображення до OpenAI. OpenAI не отримує aspectRatio або resolution напряму; коли можливо, OpenClaw зіставляє їх із підтримуваним size, інакше інструмент повідомляє про них як про проігноровані перевизначення.

Специфічні для OpenAI параметри розташовані в об’єкті openai:

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

openai.background приймає transparent, opaque або auto; прозорий вивід потребує outputFormat png або webp і моделі зображень OpenAI, здатної працювати з прозорістю. OpenClaw маршрутизує стандартні запити gpt-image-2 із прозорим фоном до gpt-image-1.5. openai.outputCompression застосовується до виводу JPEG/WebP.

Підказка верхнього рівня background є нейтральною щодо провайдера й наразі зіставляється з тим самим полем запиту OpenAI background, коли вибрано провайдера OpenAI. Провайдери, які не оголошують підтримку фону, повертають її в ignoredOverrides замість отримання непідтримуваного параметра.

Щоб маршрутизувати генерацію зображень OpenAI через розгортання Azure OpenAI замість api.openai.com, див. кінцеві точки Azure OpenAI.

Генерація зображень OpenRouter використовує той самий OPENROUTER_API_KEY і маршрутизується через API зображень чат-доповнень OpenRouter. Вибирайте моделі зображень OpenRouter із префіксом openrouter/:

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

OpenClaw пересилає prompt, count, референсні зображення та сумісні з Gemini підказки aspectRatio / resolution до OpenRouter. Поточні вбудовані скорочення моделей зображень OpenRouter включають google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview і openai/gpt-5.4-image-2. Використовуйте action: "list", щоб побачити, що надає ваш налаштований Plugin.

Генерація зображень MiniMax доступна через обидва вбудовані шляхи автентифікації MiniMax:

• minimax/image-01 для налаштувань з API-ключем
• minimax-portal/image-01 для налаштувань OAuth

Вбудований провайдер xAI використовує /v1/images/generations для запитів лише з промптом і /v1/images/edits, коли присутній image або images.

• Моделі: xai/grok-imagine-image, xai/grok-imagine-image-pro
• Кількість: до 4
• Референси: один image або до п’яти images
• Співвідношення сторін: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Роздільності: 1K, 2K
• Вивід: повертається як вкладення зображень, керовані OpenClaw

OpenClaw навмисно не надає нативні для xAI quality, mask, user або додаткові лише нативні співвідношення сторін, доки ці елементи керування не з’являться у спільному міжпровайдерному контракті image_generate.