openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh zh-CN translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-05 23:19:12 +00:00
parent 18dae69733
commit 2a9e8989d5
1 changed files with 47 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

94
docs/zh-CN/tools/image-generation.md
View File

@ -6,20 +6,20 @@ read_when:
summary: 使用已配置的提供商（OpenAI、Google Gemini、fal、MiniMax）生成和编辑图像
title: 图像生成
x-i18n:
generated_at: "2026-04-05T22:23:17Z"
generated_at: "2026-04-05T23:19:12Z"
model: gpt-5.4
provider: openai
source_hash: 7ef7849a002f2328b94d1d55e7e0c8f3a59640ba269657c4184311c316c674fd
source_hash: 46afbcbfebe0b798422208d39dc4c97584985fe8c3f08b0ed9002a0a77c5eea5
source_path: tools/image-generation.md
workflow: 15
---
# 图像生成
`image_generate` 工具让智能体能够使用你已配置的提供商来创建和编辑图像。生成的图像会作为媒体附件自动随智能体的回复一起发送。
`image_generate` 工具让智能体能够使用你已配置的提供商创建和编辑图像。生成的图像会自动作为媒体附件包含在智能体的回复中。
<Note>
只有在至少有一个图像生成提供商可用时，此工具才会显示。如果你在智能体工具中看不到 `image_generate`，请配置 `agents.defaults.imageGenerationModel` 或设置提供商 API 密钥。
只有当至少有一个图像生成提供商可用时，该工具才会显示。如果你在智能体工具中看不到 `image_generate`，请配置 `agents.defaults.imageGenerationModel` 或设置提供商 API 密钥。
</Note>
## 快速开始
@ -41,16 +41,16 @@ x-i18n:
3. 向智能体提问：_“生成一张友好的龙虾吉祥物图像。”_
智能体会自动调用 `image_generate`。不需要工具允许列表 —— 只要有可用提供商，它就会默认启用。
智能体会自动调用 `image_generate`。无需配置工具允许列表——当提供商可用时，它默认启用。
## 支持的提供商
| 提供商 | 默认模型 | 编辑支持 | API 密钥 |
| -------- | -------------------------------- | ----------------------- | ----------------------------------------------------- |
| OpenAI | `gpt-image-1` | 是（最多 5 张图像） | `OPENAI_API_KEY` |
| Google | `gemini-3.1-flash-image-preview` | 是 | `GEMINI_API_KEY` 或 `GOOGLE_API_KEY` |
| fal | `fal-ai/flux/dev` | 是 | `FAL_KEY` |
| MiniMax | `image-01` | 是（主体参考） | `MINIMAX_API_KEY` 或 MiniMax OAuth（`minimax-portal`） |
| 提供商 | 默认模型 | 编辑支持 | API 密钥 |
| ------ | -------------------------------- | ----------------------- | --------------------------------------------------------- |
| OpenAI | `gpt-image-1` | 是（最多 5 张图像） | `OPENAI_API_KEY` |
| Google | `gemini-3.1-flash-image-preview` | 是 | `GEMINI_API_KEY` 或 `GOOGLE_API_KEY` |
| fal | `fal-ai/flux/dev` | 是 | `FAL_KEY` |
| MiniMax| `image-01` | 是（主体参考） | `MINIMAX_API_KEY` 或 MiniMax OAuth（`minimax-portal`） |
使用 `action: "list"` 可在运行时查看可用的提供商和模型：
@ -60,20 +60,20 @@ x-i18n:
## 工具参数
| 参数 | 类型 | 描述 |
| 参数 | 类型 | 说明 |
| ------------- | -------- | ------------------------------------------------------------------------------------- |
| `prompt` | string | 图像生成提示词（`action: "generate"` 时必填） |
| `action` | string | `"generate"`（默认）或 `"list"`，用于查看提供商 |
| `model` | string | 提供商/模型覆盖，例如 `openai/gpt-image-1` |
| `image` | string | 编辑模式下的单张参考图像路径或 URL |
| `images` | string[] | 编辑模式下的多张参考图像（最多 5 张） |
| `size` | string | 尺寸提示：`1024x1024`、`1536x1024`、`1024x1536`、`1024x1792`、`1792x1024` |
| `aspectRatio` | string | 宽高比：`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9` |
| `resolution` | string | 分辨率提示：`1K`、`2K` 或 `4K` |
| `count` | number | 要生成的图像数量（1–4） |
| `filename` | string | 输出文件名提示 |
| `prompt` | string | 图像生成提示词（`action: "generate"` 时必填） |
| `action` | string | `"generate"`（默认）或 `"list"`，用于查看提供商 |
| `model` | string | 提供商/模型覆盖，例如 `openai/gpt-image-1` |
| `image` | string | 用于编辑模式的单张参考图像路径或 URL |
| `images` | string[] | 用于编辑模式的多张参考图像（最多 5 张） |
| `size` | string | 尺寸提示：`1024x1024`、`1536x1024`、`1024x1536`、`1024x1792`、`1792x1024` |
| `aspectRatio` | string | 宽高比：`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9` |
| `resolution` | string | 分辨率提示：`1K`、`2K` 或 `4K` |
| `count` | number | 要生成的图像数量（1–4） |
| `filename` | string | 输出文件名提示 |
并非所有提供商都支持所有参数。该工具会传递各提供商支持的参数，并忽略其余参数。
并非所有提供商都支持所有参数。工具会传递各个提供商所支持的参数，忽略其余参数，并在工具结果中报告被丢弃的覆盖项。
## 配置
@ -96,23 +96,23 @@ x-i18n:
生成图像时，OpenClaw 会按以下顺序尝试提供商：
1. 工具调用中的 **`model` 参数**（如果智能体指定了）
1. 工具调用中的 **`model` 参数**（如果智能体指定了它）
2. 配置中的 **`imageGenerationModel.primary`**
3. 按顺序使用 **`imageGenerationModel.fallbacks`**
4. **自动检测** —— 仅使用有认证支持的提供商默认值：
- 先尝试当前默认提供商
- 再按提供商 id 顺序尝试其余已注册的图像生成提供商
4. **自动检测** —— 仅使用有凭证支持的提供商默认值：
- 先使用当前默认提供商
- 再按 provider-id 顺序使用其余已注册的图像生成提供商
如果某个提供商失败（认证错误、速率限制等），会自动尝试下一个候选项。如果全部失败，错误信息将包含每次尝试的详细信息。
如果某个提供商失败（凭证错误、速率限制等），系统会自动尝试下一个候选项。如果全部失败，错误信息将包含每次尝试的详细信息。
说明：
注意：
- 自动检测会识别认证状态。只有当 OpenClaw 实际能够认证某个提供商时，该提供商默认值才会进入候选列表。
- 自动检测会感知认证状态。只有当 OpenClaw 实际上能够认证某个提供商时，该提供商默认值才会进入候选列表。
- 使用 `action: "list"` 可查看当前已注册的提供商、它们的默认模型以及认证环境变量提示。
### 图像编辑
OpenAI、Google、fal 和 MiniMax 都支持编辑参考图像。传入参考图像路径或 URL：
OpenAI、Google、fal 和 MiniMax 支持编辑参考图像。传入参考图像路径或 URL：
```
"Generate a watercolor version of this photo" + image: "/path/to/photo.jpg"
@ -120,27 +120,27 @@ OpenAI、Google、fal 和 MiniMax 都支持编辑参考图像。传入参考图
OpenAI 和 Google 通过 `images` 参数最多支持 5 张参考图像。fal 和 MiniMax 支持 1 张。
MiniMax 图像生成可通过两种内置的 MiniMax 认证路径使用：
MiniMax 图像生成功能可通过两种内置的 MiniMax 认证路径使用：
- `minimax/image-01`，用于 API 密钥配置
- `minimax-portal/image-01`，用于 OAuth 配置
- `minimax/image-01` 用于 API 密钥配置
- `minimax-portal/image-01` 用于 OAuth 配置
## 提供商能力
| 能力 | OpenAI | Google | fal | MiniMax |
| 能力 | OpenAI | Google | fal | MiniMax |
| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- |
| 生成 | 是（最多 4 张） | 是（最多 4 张） | 是（最多 4 张） | 是（最多 9 张） |
| 编辑/参考 | 是（最多 5 张图像） | 是（最多 5 张图像） | 是（1 张图像） | 是（1 张图像，主体参考） |
| 尺寸控制 | 是 | 是 | 是 | 否 |
| 宽高比 | 否 | 是 | 是（仅生成） | 是 |
| 分辨率（1K/2K/4K） | 否 | 是 | 是 | 否 |
| 生成 | 是（最多 4 张） | 是（最多 4 张） | 是（最多 4 张） | 是（最多 9 张） |
| 编辑/参考 | 是（最多 5 张图像） | 是（最多 5 张图像） | 是（1 张图像） | 是（1 张图像，主体参考） |
| 尺寸控制 | 是 | 是 | 是 | 否 |
| 宽高比 | 否 | 是 | 是（仅生成） | 是 |
| 分辨率（1K/2K/4K） | 否 | 是 | 是 | 否 |
## 相关内容
- [Tools Overview](/zh-CN/tools) —— 所有可用的智能体工具
- [fal](/providers/fal) —— fal 图像和视频提供商设置
- [Google (Gemini)](/zh-CN/providers/google) —— Gemini 图像提供商设置
- [MiniMax](/zh-CN/providers/minimax) —— MiniMax 图像提供商设置
- [OpenAI](/zh-CN/providers/openai) —— OpenAI Images 提供商设置
- [Configuration Reference](/zh-CN/gateway/configuration-reference#agent-defaults) —— `imageGenerationModel` 配置
- [Models](/zh-CN/concepts/models) —— 模型配置和故障转移
- [工具概览](/zh-CN/tools) — 所有可用的智能体工具
- [fal](/zh-CN/providers/fal) — fal 图像和视频提供商设置
- [Google（Gemini）](/zh-CN/providers/google) — Gemini 图像提供商设置
- [MiniMax](/zh-CN/providers/minimax) — MiniMax 图像提供商设置
- [OpenAI](/zh-CN/providers/openai) — OpenAI Images 提供商设置
- [配置参考](/zh-CN/gateway/configuration-reference#agent-defaults) — `imageGenerationModel` 配置
- [模型](/zh-CN/concepts/models) — 模型配置和故障切换