Generación de imágenes

Una sustitución de model por llamada prueba solo ese proveedor/modelo y no continúa con el primario/respaldo configurado ni con proveedores detectados automáticamente.

Un valor predeterminado de proveedor solo entra en la lista de candidatos cuando OpenClaw puede autenticar realmente ese proveedor. Establece agents.defaults.mediaGenerationAutoProviderFallback: false para usar solo entradas explícitas de model, primary y fallbacks.

Establece agents.defaults.imageGenerationModel.timeoutMs para backends de imagen lentos. Un parámetro de herramienta timeoutMs por llamada sustituye el valor predeterminado configurado.

Usa action: "list" para inspeccionar los proveedores registrados actualmente, sus modelos predeterminados y las indicaciones de variables de entorno de autenticación.

La generación de imágenes de OpenAI usa openai/gpt-image-2 de forma predeterminada. Si hay configurado un perfil OAuth openai-codex, OpenClaw reutiliza el mismo perfil OAuth que usan los modelos de chat de suscripción de Codex y envía la solicitud de imagen a través del backend de Responses de Codex. Las URL base heredadas de Codex como https://chatgpt.com/backend-api se canonicalizan como https://chatgpt.com/backend-api/codex para las solicitudes de imagen. OpenClaw no recurre silenciosamente a OPENAI_API_KEY para esa solicitud: para forzar el enrutamiento directo por la API de Images de OpenAI, configura models.providers.openai explícitamente con una clave de API, una URL base personalizada o un endpoint de Azure.

Los modelos openai/gpt-image-1.5, openai/gpt-image-1 y openai/gpt-image-1-mini todavía pueden seleccionarse explícitamente. Usa gpt-image-1.5 para salidas PNG/WebP con fondo transparente; la API actual de gpt-image-2 rechaza background: "transparent".

gpt-image-2 admite tanto la generación de texto a imagen como la edición con imágenes de referencia mediante la misma herramienta image_generate. OpenClaw reenvía prompt, count, size, quality, outputFormat y las imágenes de referencia a OpenAI. OpenAI no recibe aspectRatio ni resolution directamente; cuando es posible, OpenClaw asigna esos valores a un size admitido; de lo contrario, la herramienta los informa como anulaciones ignoradas.

Las opciones específicas de OpenAI están bajo el objeto openai:

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

openai.background acepta transparent, opaque o auto; las salidas transparentes requieren outputFormat png o webp y un modelo de imagen de OpenAI compatible con transparencia. OpenClaw enruta las solicitudes predeterminadas de gpt-image-2 con fondo transparente a gpt-image-1.5. openai.outputCompression se aplica a salidas JPEG/WebP.

La indicación background de nivel superior es neutral respecto al proveedor y actualmente se asigna al mismo campo de solicitud background de OpenAI cuando está seleccionado el proveedor de OpenAI. Los proveedores que no declaran compatibilidad con fondos la devuelven en ignoredOverrides en lugar de recibir el parámetro no admitido.

Para enrutar la generación de imágenes de OpenAI a través de una implementación de Azure OpenAI en lugar de api.openai.com, consulta endpoints de Azure OpenAI.

La generación de imágenes de OpenRouter usa la misma OPENROUTER_API_KEY y se enruta a través de la API de imágenes de completions de chat de OpenRouter. Selecciona modelos de imagen de OpenRouter con el prefijo openrouter/:

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

OpenClaw reenvía prompt, count, imágenes de referencia e indicaciones aspectRatio / resolution compatibles con Gemini a OpenRouter. Los accesos directos integrados actuales para modelos de imagen de OpenRouter incluyen google/gemini-3.1-flash-image-preview, google/gemini-3-pro-image-preview y openai/gpt-5.4-image-2. Usa action: "list" para ver qué expone tu plugin configurado.

La generación de imágenes de MiniMax está disponible mediante ambas rutas de autenticación MiniMax incluidas:

• minimax/image-01 para configuraciones con clave de API
• minimax-portal/image-01 para configuraciones OAuth

El proveedor xAI incluido usa /v1/images/generations para solicitudes solo con prompt y /v1/images/edits cuando image o images está presente.

• Modelos: xai/grok-imagine-image, xai/grok-imagine-image-pro
• Cantidad: hasta 4
• Referencias: una image o hasta cinco images
• Relaciones de aspecto: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Resoluciones: 1K, 2K
• Salidas: se devuelven como adjuntos de imagen gestionados por OpenClaw

OpenClaw no expone intencionalmente quality, mask, user ni relaciones de aspecto adicionales exclusivas de xAI hasta que esos controles existan en el contrato compartido image_generate entre proveedores.