# 图像编辑工具使用指南

## 功能概述

图像编辑工具是基于火山云SeedEdit 3.0 API开发的智能图像编辑工具，支持通过自然语言提示词对图像进行编辑和变换。

## 主要功能

### 1. 单张图片编辑
- 选择输入图片（支持 JPG、JPEG、PNG 格式）
- 输入编辑提示词
- 设置输出路径
- 配置编辑参数
- 实时查看编辑结果

### 2. 批量图片处理
- 选择包含图片的输入文件夹
- 选择输出文件夹
- 输入统一的编辑提示词
- 批量处理多张图片
- 实时监控处理进度

### 3. 参数配置
- **引导强度 (Guidance Scale)**: 控制提示词对生成结果的影响程度 (1.0-10.0)
- **随机种子 (Seed)**: 控制生成结果的随机性，相同种子产生相同结果
- **水印设置**: 是否在生成图片上添加"AI生成"水印
- **响应格式**: URL链接或Base64编码
- **尺寸设置**: 自适应尺寸

## 使用步骤

### 配置API密钥

1. 点击页面右上角的"配置"按钮
2. 输入火山云API密钥
3. 点击"保存配置"

### 单张图片编辑

1. 切换到"单张编辑"标签页
2. 点击"选择图片"按钮，选择要编辑的图片
3. 点击"选择路径"按钮，设置输出路径
4. 在提示词输入框中输入编辑指令，例如：
   - "改成爱心形状的泡泡"
   - "转换为水彩画风格"
   - "改为春天的樱花背景"
5. 根据需要调整右侧的参数配置
6. 点击"开始编辑"按钮
7. 等待处理完成，查看结果

### 批量图片处理

1. 切换到"批量处理"标签页
2. 点击"选择输入文件夹"，选择包含图片的文件夹
3. 点击"选择输出文件夹"，设置处理结果的保存位置
4. 输入批量编辑的提示词
5. 调整参数配置
6. 点击"开始批量处理"
7. 实时查看处理进度和结果统计

## 预设提示词

工具提供了多种分类的预设提示词，方便快速使用：

### 风格转换
- 转换为水彩画风格
- 转换为油画风格
- 转换为卡通动漫风格
- 转换为素描风格
- 转换为复古胶片风格

### 场景变换
- 改为春天的樱花背景
- 改为夏日海滩背景
- 改为秋天的枫叶背景
- 改为冬日雪景背景
- 改为城市夜景背景

### 色彩调整
- 增强色彩饱和度
- 转换为黑白照片
- 增加暖色调
- 增加冷色调
- 提高亮度和对比度

### 特效处理
- 添加光晕效果
- 添加雨滴效果
- 添加阳光透射效果
- 添加星空效果
- 添加梦幻光斑效果

## 任务管理

### 查看任务状态
1. 点击"任务管理"按钮
2. 查看所有单个任务和批量任务的状态
3. 监控任务进度和结果

### 任务状态说明
- **等待中**: 任务已创建，等待处理
- **处理中**: 任务正在执行
- **已完成**: 任务成功完成
- **失败**: 任务执行失败
- **已取消**: 任务被用户取消

### 任务操作
- **刷新**: 更新任务列表状态
- **清理已完成**: 删除已完成和失败的任务记录

## 技术规格

### 支持的图片格式
- JPEG (.jpg, .jpeg)
- PNG (.png)

### 图片要求
- 宽高比: 1/3 到 3 之间
- 最小尺寸: 宽高均大于14像素
- 最大文件大小: 10MB

### API配置
- API地址: https://ark.cn-beijing.volces.com/api/v3/images/generations
- 模型ID: doubao-seededit-3-0-i2i-250628
- 超时时间: 120秒
- 最大重试次数: 3次

## 注意事项

1. **API密钥安全**: 请妥善保管您的火山云API密钥，不要泄露给他人
2. **网络连接**: 确保网络连接稳定，图像编辑需要上传和下载数据
3. **文件路径**: 确保输出路径有写入权限
4. **批量处理**: 批量处理大量图片时请耐心等待，避免中途关闭应用
5. **费用控制**: 图像编辑会消耗API调用次数，请注意控制使用量

## 故障排除

### 常见问题

**Q: 提示"API密钥未设置"**
A: 请先在配置页面设置有效的火山云API密钥

**Q: 图片编辑失败**
A: 检查图片格式是否支持，文件大小是否超限，网络连接是否正常

**Q: 批量处理中断**
A: 检查输入文件夹是否包含有效图片，输出文件夹是否有写入权限

**Q: 处理速度慢**
A: 图像编辑需要AI模型处理，请耐心等待。可以尝试降低图片分辨率或减少批量数量

### 错误代码说明
- 网络错误: 检查网络连接
- 认证失败: 检查API密钥是否正确
- 参数错误: 检查输入参数是否符合要求
- 服务器错误: 稍后重试或联系技术支持

## 更新日志

### v1.0.0 (2024-01-31)
- 初始版本发布
- 支持单张图片编辑
- 支持批量图片处理
- 提供预设提示词
- 实现任务管理功能
- 集成火山云SeedEdit 3.0 API

## 技术支持

如遇到问题或需要技术支持，请联系开发团队或查看项目文档。
