图像生成

/tool image_generate action=list

/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",
          ],
        },
      },
    },
  },
}

"将这张照片生成水彩风格版本" + image: "/path/to/photo.jpg"