图像编辑 (Image Edit)
按提示词编辑本地图片,并把结果保存到当前用户下载目录或指定输出目录。
插件路径
plugins/image_edit/
模型优先级
image_edit_model(config.json 专用配置)> provider 默认图像编辑模型
注册工具
| 工具名 | 描述 |
|---|---|
image_edit |
根据输入图片和提示词编辑图片并保存到本地 |
参数
| 参数 | 类型 | 必需 | 默认值 | 说明 |
|---|---|---|---|---|
image |
string | 是 | — | 本地图片路径 |
prompt |
string | 是 | — | 编辑要求(如"将背景换成蓝天"、"移除图中人物") |
response_format |
string (enum) | 否 | "url" |
返回格式:url 或 b64_json |
size |
string | 否 | "" |
可选,目标尺寸,格式为 宽x高,如 1920x1080。留空使用 API 默认 |
output_dir |
string | 否 | users/<user>/download/ |
输出目录 |
filename |
string | 否 | 自动生成 | 文件名前缀(自动追加序号和 .png) |
结果说明
- 成功:返回 JSON 数组,每项包含保存后的
path、原始url(如有)、revised_prompt、finish_reason和seed - 失败:返回
ERROR:前缀的错误信息 - 能力不支持:提示需要配置
image_edit_model或开启capabilities_override: ["image_edit"]
前置条件
- 需要 provider 支持
image_edit能力 - 需配置
image_edit_model(config.json 专用配置) - 输入图片需存在于本地文件系统
典型场景
- 图片局部修改(换背景、移除物体、添加元素)
- 图片风格转换(照片转油画、赛博朋克风格等)
- 图片修复(去水印、补全缺失区域)
常见规范
- 输出目录默认为
users/<user>/download/ - 编辑要求描述越具体效果越好
size参数留空时使用 API 默认尺寸
常见处理办法
- 能力不支持:检查
image_edit_model是否已配置 - 编辑效果不理想:优化
prompt,使用更精确的描述 - 文件不存在:检查图片路径是否正确
常见教训
- 并非所有 provider 都支持 image_edit,使用前需确认能力声明
response_format设为b64_json时响应体较大,网络条件差时建议用url- 编辑结果可能与预期有差异,部分模型对指令的理解有限