# Image Edit

> 图像编辑工具，使用当前 provider 的 image_edit 能力对本地图片按提示词编辑并保存结果。

- Skill: `kesepain-ke/image-edit` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add kesepain-ke/image-edit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kesepain-ke/image-edit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kesepain-ke (https://skillmd.com/u/kesepain-ke)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kesepain-ke/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`
- 编辑结果可能与预期有差异，部分模型对指令的理解有限