image-edit

name	image_edit
description	图像编辑工具，使用当前 provider 的 image_edit 能力对本地图片按提示词编辑并保存结果。
version	1.1
category	multimodal
enabled	true
tags	["multimodal","image","edit"]

图像编辑 (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
• 编辑结果可能与预期有差异，部分模型对指令的理解有限