> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 图像生成

`image_generate` 工具通过你配置的提供方创建和编辑图像。在聊天会话中，它会异步运行：OpenClaw 记录一个后台任务，立即返回任务 ID，并在提供方完成任务后唤醒代理。任务记录会保持静默，而完成代理会遵循会话当前的可见回复约定，发送简短的面向用户的说明以及每个结构化的生成附件。如果生成失败，代理会改为返回简洁的可见失败消息。如果请求方会话处于非活动状态，或其活动唤醒失败，OpenClaw 会发送一条包含生成图像的幂等直接回退消息，以免结果丢失。

<Note>
  该工具仅在至少有一个图像生成提供方可用时才会显示。如果你在 agent 的工具中看不到 `image_generate`，请配置 `agents.defaults.mediaModels.image`，设置提供方 API 密钥，或通过 OpenAI ChatGPT/Codex OAuth 登录。
</Note>

## 快速开始

<Steps>
  <Step title="配置认证">
    为至少一个提供方设置 API 密钥（例如 `OPENAI_API_KEY`、
    `GEMINI_API_KEY`、`OPENROUTER_API_KEY`）或使用 OpenAI Codex OAuth 登录。
  </Step>

  <Step title="选择默认模型（可选）">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          mediaModels: {
            image: {
              primary: "openai/gpt-image-2",
              timeoutMs: 180000,
            },
          },
        },
      },
    }
    ```

    ChatGPT/Codex OAuth 使用相同的 `openai/gpt-image-2` 模型引用。当配置了
    `openai` OAuth 配置文件时，OpenClaw 会通过该 OAuth 配置文件路由图像请求，
    而不是先尝试 `OPENAI_API_KEY`。显式的 `models.providers.openai` 配置（API 密钥、自定义/Azure 基础 URL）
    会切换回直接使用 OpenAI Images API 路由。
  </Step>

  <Step title="让 agent 执行">
    *“生成一张友好机器人吉祥物的图片。”*

    agent 会自动调用 `image_generate`。无需配置工具允许列表——当提供方可用时，
    该工具默认启用。该工具会返回一个后台任务 ID，然后完成 agent 会在准备就绪后回复每个生成的附件。
  </Step>
</Steps>

<Warning>
  对于 OpenAI 兼容的 LAN 端点，例如 LocalAI，请保留自定义的
  `models.providers.openai.baseUrl`，并显式启用 `browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true`。默认情况下，私有和
  内部图像端点仍会被阻止。
</Warning>

## 常用路由

| 目标                         | 模型引用                                               | 认证                                    |
| -------------------------- | -------------------------------------------------- | ------------------------------------- |
| OpenAI 使用 API 计费进行图像生成     | `openai/gpt-image-2`                               | `OPENAI_API_KEY`                      |
| 使用 Codex 订阅认证的 OpenAI 图像生成 | `openai/gpt-image-2`                               | OpenAI ChatGPT/Codex OAuth            |
| OpenAI 透明背景 PNG/WebP       | `openai/gpt-image-1.5`                             | `OPENAI_API_KEY` 或 OpenAI Codex OAuth |
| DeepInfra 图像生成             | `deepinfra/black-forest-labs/FLUX-1-schnell`       | `DEEPINFRA_API_KEY`                   |
| fal Krea 2 表达式/风格导向生成      | `fal/krea/v2/medium/text-to-image`                 | `FAL_KEY`                             |
| OpenRouter 图像生成            | `openrouter/google/gemini-3.1-flash-image-preview` | `OPENROUTER_API_KEY`                  |
| LiteLLM 图像生成               | `litellm/gpt-image-2`                              | `LITELLM_API_KEY`                     |
| Microsoft Foundry MAI 图像生成 | `microsoft-foundry/<deployment-name>`              | `AZURE_OPENAI_API_KEY` 或 Entra ID     |
| Google Gemini 图像生成         | `google/gemini-3.1-flash-image`                    | `GEMINI_API_KEY` 或 `GOOGLE_API_KEY`   |

同一个工具同时处理文本到图像和参考图像编辑。对单个参考图像使用 `image`，对多个参考图像使用 `images`。对于 fal 上的 Krea 2 模型，这些参考图像会作为风格参考发送，而不是作为编辑输入。\
当可用时，诸如 `quality`、`outputFormat` 和 `background` 之类的提供方支持的输出提示会被转发；当某个提供方未声明支持时，则会报告为被忽略。内置的透明背景支持是 OpenAI 特有的；其他提供方如果其后端输出了 PNG alpha 通道，仍可能保留该通道。

OpenAI 通过直接的 Images API 或 Codex Responses 后端，支持文本到图像生成和参考图像编辑使用 `low` 和 `auto` 内容审核。对于 CLI 请求，请将 `--openai-moderation low|auto` 传递给 `openclaw infer image generate` 或 `openclaw infer image edit`。

## 支持的提供方

| 提供方               | 默认模型                                    | 编辑支持                  | 认证                                                  |
| ----------------- | --------------------------------------- | --------------------- | --------------------------------------------------- |
| ComfyUI           | `workflow`                              | 是（1 张图片，按工作流配置）       | 云端使用 `COMFY_API_KEY` 或 `COMFY_CLOUD_API_KEY`        |
| DeepInfra         | `black-forest-labs/FLUX-1-schnell`      | 是（1 张图片）              | `DEEPINFRA_API_KEY`                                 |
| fal               | `fal-ai/flux/dev`                       | 是（模型特定限制）             | `FAL_KEY`                                           |
| Google            | `gemini-3.1-flash-image`                | 是（最多 5 张图片）           | `GEMINI_API_KEY` 或 `GOOGLE_API_KEY`                 |
| LiteLLM           | `gpt-image-2`                           | 是（最多 5 张输入图片）         | `LITELLM_API_KEY`                                   |
| Microsoft Foundry | `<deployment-name>`                     | 是（仅 MAI-Image-2.5 模型） | `AZURE_OPENAI_API_KEY` 或 Entra ID（`az login`）       |
| MiniMax           | `image-01`                              | 是（主体参考）               | `MINIMAX_API_KEY` 或 MiniMax OAuth（`minimax-portal`） |
| OpenAI            | `gpt-image-2`                           | 是（最多 5 张图片）           | `OPENAI_API_KEY` 或 OpenAI ChatGPT/Codex OAuth       |
| OpenRouter        | `google/gemini-3.1-flash-image-preview` | 是（最多 5 张输入图片）         | `OPENROUTER_API_KEY`                                |
| Vydra             | `grok-imagine`                          | 否                     | `VYDRA_API_KEY`                                     |
| xAI               | `grok-imagine-image`                    | 是（最多 3 张图片）           | `XAI_API_KEY`                                       |

在运行时使用 `action: "list"` 来检查可用的提供方和模型：

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/tool image_generate action=list
```

使用 `action: "status"` 来检查当前会话中的活动图像生成任务：

````text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/tool image_generate action=status

## 提供方能力

| 能力                  | ComfyUI            | DeepInfra | fal                                            | Google         | Microsoft Foundry | MiniMax               | OpenAI         | Vydra | xAI            |
| --------------------- | ------------------ | --------- | ---------------------------------------------- | -------------- | ----------------- | --------------------- | -------------- | ----- | -------------- |
| 生成（最大数量）      | 1                  | 4         | 4                                              | 4              | 1                 | 9                     | 4              | 1     | 4              |
| 编辑 / 参考           | 1 张图片（工作流） | 1 张图片  | Flux：1；GPT：10；Krea 风格参考：10；NB2：14 | 最多 5 张图片  | 1 张图片          | 1 张图片（主体参考） | 最多 5 张图片  | -     | 最多 3 张图片  |
| 尺寸控制              | -                  | ✓         | ✓                                              | ✓              | ✓                 | -                     | 最大 4K        | -     | -              |
| 宽高比                | -                  | -         | ✓                                              | ✓              | -                 | ✓                     | -              | -     | ✓              |
| 分辨率（1K/2K/4K）    | -                  | -         | ✓                                              | ✓              | -                 | -                     | -              | -     | 1K、2K         |

## 工具参数

<ParamField path="prompt" type="string" required>
  图像生成提示词。`action: "generate"` 时必填。
</ParamField>
<ParamField path="action" type='"generate" | "status" | "list"' default="generate">
  使用 `"status"` 检查当前会话任务，或使用 `"list"` 在运行时检查
  可用的提供方和模型。
</ParamField>
<ParamField path="model" type="string">
  覆盖提供方/模型（例如 `openai/gpt-image-2`）。透明 OpenAI 背景使用
  `openai/gpt-image-1.5`。
</ParamField>
<ParamField path="image" type="string">
  编辑模式下单个参考图像路径或 URL。
</ParamField>
<ParamField path="images" type="string[]">
  用于编辑模式或风格参考模型的多个参考图像（通过共享工具最多 14 张，
  但仍受提供方具体限制约束）。
</ParamField>
<ParamField path="size" type="string">
  尺寸提示：`1024x1024`、`1536x1024`、`1024x1536`、`2048x2048`、`3840x2160`。
</ParamField>
<ParamField path="aspectRatio" type="string">
  宽高比：`1:1`、`2:1`、`20:9`、`19.5:9`、`2:3`、`3:2`、`2.35:1`、`3:4`、
  `4:3`、`4:5`、`5:4`、`9:16`、`9:19.5`、`9:20`、`16:9`、`21:9`、`1:2`、`4:1`、
  `1:4`、`8:1`、`1:8`。提供方会验证其特定于模型的子集。
</ParamField>
<ParamField path="resolution" type='"1K" | "2K" | "4K"'>分辨率提示。</ParamField>
<ParamField path="quality" type='"low" | "medium" | "high" | "auto"'>
  在提供方支持时使用的质量提示。
</ParamField>
<ParamField path="outputFormat" type='"png" | "jpeg" | "webp"'>
  在提供方支持时使用的输出格式提示。
</ParamField>
<ParamField path="background" type='"transparent" | "opaque" | "auto"'>
  在提供方支持时使用的背景提示。对于支持透明背景的提供方，请将
  `outputFormat: "png"` 或 `"webp"` 与 `transparent` 一起使用。
</ParamField>
<ParamField path="count" type="number">要生成的图片数量（1-4）。</ParamField>
<ParamField path="timeoutMs" type="number">
  可选的提供方请求超时时间，单位为毫秒。当 Codex 通过动态工具调用
  `image_generate` 时，这个每次调用的值仍会覆盖
  已配置的默认值，上限为 600000 毫秒。
</ParamField>
<ParamField path="filename" type="string">输出文件名提示。</ParamField>
<ParamField path="openai" type="object">
  仅适用于 OpenAI 的提示：`background`、`moderation`、`outputCompression` 和 `user`。
</ParamField>
<ParamField path="fal.creativity" type='"raw" | "low" | "medium" | "high"'>
  fal Krea 2 创意控制。默认值为 `medium`。
</ParamField>

<Note>
并非所有提供方都支持所有参数。当回退提供方支持与请求相似但不完全相同的几何选项时，OpenClaw 会在提交前将其映射到最接近的受支持尺寸、宽高比或分辨率。对于未声明支持的提供方，不受支持的输出提示会被忽略，并在工具结果中报告。工具结果会报告已应用的设置；`details.normalization` 会记录从请求值到实际应用值的任何转换。
</Note>

## 配置

### 模型选择

```json5
{
  agents: {
    defaults: {
      mediaModels: {
        image: {
          primary: "openai/gpt-image-2",
          timeoutMs: 180000,
          fallbacks: [
            "openrouter/google/gemini-3.1-flash-image-preview",
            "google/gemini-3.1-flash-image",
            "fal/fal-ai/flux/dev",
          ],
        },
      },
    },
  },
}
````

### 提供方选择顺序

OpenClaw 会按以下顺序尝试提供方：

1. **`model` 参数**，来自工具调用（如果代理指定了该参数）。
2. 来自配置的 **`agents.defaults.mediaModels.image.primary`**。
3. 按顺序使用 **`agents.defaults.mediaModels.image.fallbacks`**。
4. **自动检测**——仅限基于认证的提供方默认值：
   * 首先使用当前默认提供方；
   * 然后按提供方 ID 顺序使用其余已注册的图像生成提供方。

如果某个提供方失败（认证错误、速率限制等），会自动尝试下一个已配置的候选项。如果全部失败，错误信息会包含每次尝试的详细信息。

<AccordionGroup>
  <Accordion title="单次调用的模型覆盖是精确的">
    单次调用的 `model` 覆盖只会尝试该提供方/模型，不会继续使用已配置的 primary/fallback
    或自动检测到的提供方。
  </Accordion>

  <Accordion title="自动检测是感知认证的">
    只有当 OpenClaw 实际能够对该提供方进行认证时，提供方默认值才会进入候选列表。
    已认证提供方之间的自动回退始终启用；每次调用的 `model` 仍然具有最高优先级。
  </Accordion>

  <Accordion title="超时">
    为较慢的图像后端设置 `agents.defaults.mediaModels.image.timeoutMs`。
    每次调用的 `timeoutMs` 工具参数会覆盖已配置默认值，而已配置默认值会覆盖插件编写的提供方默认值。
    Google 和 OpenRouter 托管的图像提供方默认使用 180 秒；Microsoft Foundry MAI、xAI 和 Azure OpenAI 图像生成默认使用 600 秒。
    Codex 动态工具调用使用 120 秒的 `image_generate` 桥接默认值，并在已配置时遵守相同的超时预算，上限受 OpenClaw 的 600000 毫秒动态工具桥接最大值限制。
  </Accordion>

  <Accordion title="运行时检查">
    使用 `action: "list"` 检查当前已注册的提供方、
    它们的默认模型以及认证环境变量提示。
  </Accordion>
</AccordionGroup>

### 图像编辑

OpenAI、OpenRouter、Google、DeepInfra、fal、Microsoft Foundry、MiniMax、
ComfyUI 和 xAI 支持编辑参考图像。fal 上的 Krea 2 模型使用相同的 `image` / `images` 字段作为风格参考，而不是编辑输入。传入参考图像路径或 URL：

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
"将这张照片生成水彩风格版本" + image: "/path/to/photo.jpg"
```

OpenAI、OpenRouter 和 Google 通过 `images` 参数支持最多 5 张参考图像；xAI 支持最多 3 张。fal 支持 1 张用于 Flux 图像到图像的参考图像、最多 10 张用于 GPT Image 2 编辑、最多 10 张用于 Krea 2 风格参考，以及最多 14 张用于 Nano Banana 2 编辑。Microsoft Foundry、MiniMax 和 ComfyUI 支持 1 张。

## 提供方深度解析

<AccordionGroup>
  <Accordion title="OpenAI gpt-image-2（以及 gpt-image-1.5）">
    OpenAI 图像生成默认使用 `openai/gpt-image-2`。如果配置了 `openai` OAuth 配置文件，OpenClaw 将复用与 Codex 订阅聊天模型相同的 OAuth 配置文件，并通过 Codex Responses 后端发送图像请求。像 `https://chatgpt.com/backend-api` 这样的旧版 Codex 基础 URL 会在图像请求中规范化为 `https://chatgpt.com/backend-api/codex`。OpenClaw 不会为此请求静默回退到 `OPENAI_API_KEY`——若要强制直接路由到 OpenAI Images API，请显式配置 `models.providers.openai` 并提供 API key、自定义基础 URL 或 Azure 端点。

    仍然可以显式选择 `openai/gpt-image-1.5`、`openai/gpt-image-1` 和
    `openai/gpt-image-1-mini` 模型。若要输出透明背景的 PNG/WebP，请使用
    `gpt-image-1.5`；当前
    `gpt-image-2` API 会拒绝 `background: "transparent"`。

    `gpt-image-2` 通过同一个 `image_generate` 工具同时支持文生图和
    参考图编辑。OpenClaw 会将 `prompt`、`count`、`size`、`quality`、`outputFormat`
    以及参考图转发给 OpenAI。OpenAI 不直接接受
    `aspectRatio` 或 `resolution`；在可能的情况下，OpenClaw 会将这些参数映射为受支持的 `size` 值，否则工具会将其报告为
    被忽略的覆盖项。

    对于直接的 OpenAI Images API 请求，`gpt-image-2` 及其
    `gpt-image-2-2026-04-21` 快照会保留有效的显式
    `WIDTHxHEIGHT` 尺寸，而不是将其调整为预设值。两个
    维度都必须是 16 的倍数，且都不得超过 3840 像素，
    宽高比不得超过 3:1，图像像素数必须介于
    655,360 和 8,294,400 之间。例如，`1024x640` 是
    有效的。当仅指定 `aspectRatio` 时，OpenClaw 仍会选择最接近的受支持尺寸。

    OpenAI 专属选项位于 `openai` 对象中：

    ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      "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 输出，对
    PNG 输出会被忽略。

    顶层的 `background` 提示是提供方无关的，目前在选择 OpenAI 时会映射到同一个 OpenAI `background` 请求字段。对于未声明背景支持的提供方，它会作为 `ignoredOverrides` 返回，而不是发送不受支持的参数。

    若要通过 Azure OpenAI 部署而不是 `api.openai.com` 路由 OpenAI 图像生成，请参见
    [Azure OpenAI 端点](/providers/openai#azure-openai-endpoints)。
  </Accordion>

  <Accordion title="Microsoft Foundry MAI 图像模型">
    Microsoft Foundry 图像生成使用已部署的 MAI 图像部署名称，
    并通过 `microsoft-foundry/` 提供方前缀引用。提供方级别没有
    默认模型，因为 MAI API 期望你在 `model` 字段中提供部署名称：

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          mediaModels: {
            image: {
              primary: "microsoft-foundry/<deployment-name>",
              timeoutMs: 600000,
            },
          },
        },
      },
    }
    ```

    该提供方使用的是 Microsoft Foundry 的 MAI API，而不是 OpenAI Images API：

    * 生成端点：`/mai/v1/images/generations`
    * 编辑端点：`/mai/v1/images/edits`
    * 身份验证：`AZURE_OPENAI_API_KEY` / 提供方 API key，或通过 `az login` 使用 Entra ID
    * 输出：一张 PNG 图像
    * 尺寸：默认 `1024x1024`；宽度和高度都必须至少为 768 px，
      且总像素数最多为 1,048,576
    * 编辑：一张 PNG 或 JPEG 参考图，仅
      `MAI-Image-2.5-Flash` 和 `MAI-Image-2.5` 部署支持

    仅基于提示词的生成可以使用自定义部署名称，只要
    已配置 Foundry 端点即可。使用自定义部署名称进行编辑则需要 starter/model 元数据，以便 OpenClaw 可以验证该部署是否由
    `MAI-Image-2.5-Flash` 或 `MAI-Image-2.5` 支持。

    当前的 MAI 图像模型有 `MAI-Image-2.5-Flash`、`MAI-Image-2.5`、
    `MAI-Image-2e` 和 `MAI-Image-2`。关于设置
    和聊天模型行为，请参见
    [Microsoft Foundry 插件](/plugins/reference/microsoft-foundry)。
  </Accordion>

  <Accordion title="OpenRouter 图像模型">
    OpenRouter 图像生成使用相同的 `OPENROUTER_API_KEY`，
    并通过 OpenRouter 的聊天补全图像 API 路由。使用
    `openrouter/` 前缀来选择 OpenRouter 图像模型：

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          mediaModels: {
            image: {
              primary: "openrouter/google/gemini-3.1-flash-image-preview",
            },
          },
        },
      },
    }
    ```

    OpenClaw 会将 `prompt`、`count`、参考图，以及
    与 Gemini 兼容的 `aspectRatio` / `resolution` 提示转发给 OpenRouter。
    当前内置的 OpenRouter 图像模型快捷方式包括
    `google/gemini-3.1-flash-image`、
    `google/gemini-3-pro-image` 和 `openai/gpt-5.4-image-2`。使用
    `action: "list"` 查看你配置的插件暴露了哪些模型。
  </Accordion>

  <Accordion title="fal Krea 2">
    fal 上的 Krea 2 模型使用 fal 原生的 Krea schema，而不是 Flux 使用的通用
    `image_size` schema。OpenClaw 发送：

    * `aspect_ratio` 用于宽高比提示
    * `creativity`，默认值为 `medium`
    * 当提供 `image` 或 `images` 时使用 `image_style_references`

    选择 Krea 2 Medium 可获得更快、更具表现力的插画；或选择 Krea 2 Large，
    以获得更慢但更详细的写实效果和纹理：

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          mediaModels: {
            image: {
              primary: "fal/krea/v2/medium/text-to-image",
            },
          },
        },
      },
    }
    ```

    Krea 2 目前每次请求仅返回一张图像。Krea 推荐优先使用 `aspectRatio`；OpenClaw 会将 `size` 映射到最接近的受支持 Krea 宽高比，并会将 `resolution` 作为被 Krea 拒绝的项返回，而不是直接丢弃。若你需要原生 Krea 创意等级，请使用 `fal.creativity`：

    ```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      "model": "fal/krea/v2/medium/text-to-image",
      "prompt": "A cyber zine portrait with risograph texture",
      "aspectRatio": "9:16",
      "fal": {
        "creativity": "high"
      }
    }
    ```
  </Accordion>

  <Accordion title="MiniMax 双重认证">
    MiniMax 图像生成可以使用两种内置的 MiniMax
    认证路径之一：

    * `minimax/image-01` 用于 API key 配置
    * `minimax-portal/image-01` 用于 OAuth 配置
  </Accordion>

  <Accordion title="xAI grok-imagine-image">
    内置的 xAI 提供方在仅有提示词请求时使用 `/v1/images/generations`，
    当存在 `image` 或 `images` 时使用 `/v1/images/edits`。

    * 模型：`xai/grok-imagine-image`、`xai/grok-imagine-image-quality`
    * 数量：最多 4
    * 参考图：一张 `image` 或最多三张 `images`
    * 宽高比：`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`
    * 分辨率：`1K`、`2K`
    * 输出：作为 OpenClaw 托管的图像附件返回

    在共享的跨提供方 `image_generate` 合约中尚未具备这些控制项之前，OpenClaw 故意不暴露 xAI 原生的 `quality`、`mask`、
    `user` 或 `auto` 宽高比。
  </Accordion>
</AccordionGroup>

## 示例

<Tabs>
  <Tab title="生成（4K 横版）">
    ```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
    /tool image_generate action=generate model=openai/gpt-image-2 prompt="为 OpenClaw 图像生成设计一张干净的编辑风格海报" size=3840x2160 count=1
    ```
  </Tab>

  <Tab title="生成（透明 PNG）">
    ```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
    /tool image_generate action=generate model=openai/gpt-image-1.5 prompt="一个简单的红色圆形贴纸，透明背景" outputFormat=png background=transparent
    ```

    等效 CLI：

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw infer image generate \
      --model openai/gpt-image-1.5 \
      --output-format png \
      --background transparent \
      --prompt "一个简单的红色圆形贴纸，透明背景" \
      --json
    ```
  </Tab>

  <Tab title="生成（OpenAI 低质量）">
    ```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
    /tool image_generate action=generate model=openai/gpt-image-2 prompt="为一款安静的效率应用制作一张低成本草稿海报" quality=low openai='{"moderation":"low"}'
    ```

    等效 CLI：

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw infer image generate \
      --model openai/gpt-image-2 \
      --quality low \
      --openai-moderation low \
      --prompt "为一款安静的效率应用制作一张低成本草稿海报" \
      --json
    ```
  </Tab>

  <Tab title="生成（两个正方形）">
    ```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
    /tool image_generate action=generate model=openai/gpt-image-2 prompt="为一款平静的效率应用图标提供两个视觉方向" size=1024x1024 count=2
    ```
  </Tab>

  <Tab title="编辑（一个参考图）">
    ```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
    /tool image_generate action=generate model=openai/gpt-image-2 prompt="保留主体，但将背景替换为明亮的工作室场景" image=/path/to/reference.png size=1024x1536
    ```
  </Tab>

  <Tab title="编辑（多个参考图）">
    ```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
    /tool image_generate action=generate model=openai/gpt-image-2 prompt="将第一张图中的角色身份与第二张图中的配色方案结合起来" images='["/path/to/character.png","/path/to/palette.jpg"]' size=1536x1024
    ```
  </Tab>

  <Tab title="Krea 样式参考">
    ```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
    /tool image_generate action=generate model=fal/krea/v2/medium/text-to-image prompt="使用这套配色和印刷纹理制作一张富有表现力的编辑风格肖像" images='["/path/to/palette.png","/path/to/texture.jpg"]' aspectRatio=9:16 fal='{"creativity":"high"}'
    ```
  </Tab>
</Tabs>

`--output-format`、`--background` 和 `--quality` 标志同样适用于
`openclaw infer image edit`；`--openai-background` 仍是一个
OpenAI 专用别名。对 OpenAI 图像生成和参考图编辑均可使用
`--openai-moderation low|auto`。直接的 OpenAI Images API 以及
ChatGPT/Codex OAuth Responses 后端都支持 moderation 提示。
除 OpenAI 外，当前捆绑的其他提供商均未声明
显式的背景控制，因此对它们而言，`background: "transparent"` 会报告为
已忽略。

## 相关内容

* [工具概览](/tools) - 所有可用的代理工具
* [ComfyUI](/providers/comfy) - 本地 ComfyUI 和 Comfy Cloud 工作流设置
* [fal](/providers/fal) - fal 图像和视频提供商设置
* [Google（Gemini）](/providers/google) - Gemini 图像提供商设置
* [Microsoft Foundry 插件](/plugins/reference/microsoft-foundry) - Microsoft Foundry 聊天和 MAI 图像设置
* [MiniMax](/providers/minimax) - MiniMax 图像提供商设置
* [OpenAI](/providers/openai) - OpenAI Images 提供商设置
* [Vydra](/providers/vydra) - Vydra 图像、视频和语音设置
* [xAI](/providers/xai) - Grok 图像、视频、搜索、代码执行和 TTS 设置
* [配置参考](/gateway/config-agents#agent-defaults) - `agents.defaults.mediaModels.image` 配置
* [模型](/concepts/models) - 模型配置和故障转移