功能关键词:图片文字替换、海报文字修改、图片文字翻译、逐图CSV提示词、本地批量编辑。
工具概述
批量AI图片文字替换工具将图片和编辑指令发送至用户设置的图片编辑API,可用于替换、翻译、擦除商品图片、海报、包装、标牌、扫描图片中的文字,或调整文字颜色和字号。实际图片由所选服务和模型返回。
页面支持统一提示词、逐图多版本、逐图CSV规则、按相对位置进行局部编辑、原图对比,并提供并发限速、格式与尺寸设置、从任务数据库恢复、报告。保持原有样式是向模型提出的要求,不能用于承诺所有文字和背景像素都会符合预期。
工具截图

主要功能
- 接受单张图片、多张图片、目录的混合输入,支持追加输入源、遍历子目录、保留输出层级。
- 为整个批次应用统一编辑指令,或为每张原图单独生成对应多个提示词组的版本。
- 使用UTF-8的CSV,通过路径为每张图片匹配专用指令,不匹配时可选择跳过或回退至统一指令。
- 提供原位替换、文字翻译、文字擦除、颜色与字号这4类提示词示例。
- 在代表图片上选择矩形,为整个批次使用相同的相对区域,仅编辑该局部区域后放回原图。
- 连接Images编辑、Responses图片工具、Sub2API异步接口。
- 设置并发数、提交限速、重试、上传尺寸、API的质量与尺寸、以PNG/JPEG/WebP保存。
- 保存任务数据库、状态报告和扫描异常,支持停止、恢复、失败重试、结果对比。
使用前的准备
请准备PNG、JPG、JPEG、WebP、BMP、TIF或TIFF静态图片;不处理多帧或多页内容,GIF动画无法直接提交。
请准备服务商的API地址、API Key、实际支持图片编辑的模型名称;即使使用New API和Sub2API预设,也需要自己的地址和密钥。
请选择保存目录;不能是主输入目录本身或其父目录;可以是输入子目录,该输出子树会在扫描时被排除。
请准备明确的原文字、新文字、位置和保留要求。逐图模式需要表头为path,prompt的UTF-8的CSV;要对多个版本分组,请在独立行使用---。
密钥栏标明不会保存;图片和提示词将发送至所配置的服务。实际生成和重试的调用费用由相应服务决定,本教程制作中未发生这些调用。
详细操作步骤
1. 添加图片输入源,选择保存目录和输出层级
请点击“路径设置”中“输入图片”旁的“浏览”;菜单中有“选择图片(可多选)”、“选择文件夹”、“追加图片”、“追加文件夹”;也可以拖入输入源来追加。普通选择会替换输入源,追加选项会与现有路径合并并去重。
手动输入的多个路径请用半角分号 ; 分隔;程序也可能将多个选择显示为JSON路径列表。请勿在单个路径内包含分号的情况下,将其作为普通分隔字符串输入;请优先使用选择按钮自动处理。
请点击“保存目录”旁的“浏览”,或拖入目录来添加。输出位置不能是主输入文件夹本身或其父目录;输出位置位于输入内时,其子树会被排除,新结果不会继续被视为输入源。
要扫描子文件夹,请先勾选“遍历子目录”,再按需勾选“保留原路径结构”。单个根目录会保留内部相对层级,多个根目录还会分别添加各自的根目录名,同名根目录会编号;关闭结构保留后,所有输出会集中放置,重名会自动避让。
程序不会跟随符号链接或目录联接。截图中输入源和输出位置均为空,尚未扫描或加载图片。

2. 输入API地址和密钥,匹配协议与模型
请在“参数与操作”顶部选择New API、Sub2API、OpenAI或自定义。服务预设并不意味着内置可用账户;需要在旁边输入实际的API基础地址和密钥。选择OpenAI且地址为空时,会填入其默认地址,但协议需要根据服务支持情况手动选择。
地址使用HTTP或HTTPS,不含用户名、密码、查询参数、空白。无路径的根域名会添加/v1,已有的/v1或自定义路径前缀会保留;输入完整编辑端点时,程序会先将其规范化为基础地址。
“Images编辑”调用图片编辑接口,模型栏需要指定服务提供的编辑模型,页面初始值为gpt-image-1;“Responses图片工具”要求主界面的模型支持调用图片工具,内部图片模型可在高级参数中另行填写;“Sub2API异步”要求服务器启用异步任务接口。
API Key默认隐藏,可通过旁边的“显示”临时查看;密钥仅用于当前会话,不会写入配置或任务报告。开始新任务或恢复前,请输入与地址匹配的当前密钥。
“连接测试”仅通过查询/models确认连接和认证,不生成图片,也不证明模型具有编辑权限;部分服务不公开/models。本文未点击测试,也未输入密钥或调用服务。

3. 选择统一或多版本提示词,描述实际要修改的文字对象
在模式下拉框中保持“统一提示词”时,下方编辑框内的一组指令会应用于所有图片。请指定要替换的原文字、新文字及其位置,避免仅为“修改一些内容”这类无法定位的要求。
旁边的场景列表有原位替换、文字翻译、文字擦除、颜色/字号。实际使用时,选择场景并点击“填入示例”会覆盖当前编辑框内容,之后可将示例内容改为实际要求;本次未填入示例或其他测试文本。
选择“逐图多版本”时,请用独立行的---分隔各指令组,最多100组。每组独立作用于同一张原图,并非将第一组的结果交给下一组继续修改;任务数会按图片数乘以组数增加。
提示词支持含扩展名的{filename}、不含扩展名的{stem}、相对路径{relative_path}这3个变量,程序只替换这些已知变量。这些变量可用于在指令中写入相应文件名等内容。
“保持原有样式”默认启用,会自动追加关于字体、字重、透视、背景质感、目标不存在时不凭空添加的要求。这是提示词要求,并非本地OCR验证或文字准确性保证,实际使用时需要检查模型返回的结果。

4. 需要逐图指令时切换至CSV模式,设置不匹配时的处理方式
在模式栏选择“逐图CSV提示词”后,同一行会显示CSV路径栏和“选择CSV”。实际使用时,请先点击“CSV模板”保存示例表,在自己的表格软件中填写并保存为UTF-8的CSV;图片仍由上方输入源栏指定,CSV不替代图片输入。
表头必须恰好各包含一个path列和prompt列。请在path填写图片路径,在prompt填写该图片的指令;提示词包含半角逗号时,请正确使用CSV双引号包围。路径重复、路径为空或提示词为空时,导入会中止并指出其位置。
匹配优先级依次为完整路径、以根目录名为前缀的相对路径、根目录内的相对路径、仅文件名。仅文件名会匹配多个目录中的同名图片;需要区分时,请填写更具体的相对路径或完整路径。
不匹配项默认跳过并记录。在“高级参数→速度与输出→CSV不匹配时”中,可将其改为“使用统一提示词”,并在主界面的大编辑框中填写回退指令;保持默认跳过行为时,此回退编辑框可留空。
图片未匹配CSV并不意味着该图片无法打开;请在任务报告中查看跳过原因。截图中仅为展示输入栏而切换至CSV模式,未选择CSV、保存模板或创建测试数据。

5. 需要局部修改时,设置整个批次共用的相对区域
请点击参数卡片底部的“局部选区”,打开“将相同相对区域应用于整个批次”窗口。实际使用时,请点击“选择原图”选择代表图片,在图片上拖出矩形覆盖完整目标文字,最后点击“应用选区”返回。
程序将区域保存为相对坐标,用于本批次的每张图片,因此适合文字位置一致的版式;不会为每张图片单独自动检测文字位置。不同版式需要分批处理,避免同一矩形覆盖无关区域。
局部模式仅将裁剪区域发送给模型,将返回区域缩放至原选区尺寸后贴回输入源画布;局部输出始终保持原图尺寸。PNG和无损压缩的WebP可保留框外画布内容,但JPEG还会对整张图片进行有损重编码。
要恢复整图编辑,请在此窗口点击“清除选区”后应用;“取消”会丢弃当前更改。预览图片会根据窗口显示比例缩放,不会修改原文件。
此图实际显示“请选择图片”;未选择代表图片、拖出矩形或应用选区,截图后通过取消返回。

6. 在“速度与输出”页面设置并发数、限速和保存规则
点击“高级参数”后,默认打开“速度与输出”。并发任务数为1至8,默认值为2;每分钟请求数为0至6000,默认值为20,0表示不限。限速仅统计生成提交;轮询和结果下载不计入此每分钟数值。
请求超时为10秒至1800秒,默认值为300,是单次网络请求的最大等待时间。限流重试次数为0至5,默认值为2,退避重试仅适用于明确的HTTP429和503响应;网络中断或超时可能被标记为待确认结果,以避免立即重新提交。
输出格式为PNG、JPEG或WebP,默认值为PNG;WebP以无损压缩保存,JPEG质量为60至100,默认值为95,透明部分会填充白色。JPEG质量仅影响本地编码,无法提高模型返回文字的忠实度。
输出文件名后缀默认为_已修改,也可留空,最多48个字符,不包含无效文件名字符。多版本会添加_v01、_v02等,已有同名文件时会添加编号,不会覆盖其他文件。
不匹配的CSV项默认跳过,可选择回退至统一提示词。“将整图结果恢复至原图尺寸”默认勾选,会将模型返回的整图缩放至输入源像素尺寸;关闭后保留返回尺寸,但局部模式仍使用输入源固定尺寸,恢复尺寸也不会增加细节。
实际调整后点击“应用”会用于下一个新任务,但恢复原任务时仍使用原参数;“取消”会丢弃更改。本次仅查看默认值,未应用或保存参数。

7. 在“图片与接口”页面设置上传限制和服务专用参数
请切换至“图片与接口”。上传最长边为256至8192,默认值为2048;上传前仅会将超尺寸图片或选区按比例缩小,不会放大小图片;提交内容会转换为PNG。这不会直接决定模型返回图片的尺寸。
文件限制为1至100MB,默认值为25,同时检查原文件和已编码的上传用PNG。像素限制为100万至4000万,默认值为2500万,限制输入图片和返回图片;多帧、多页、超限图片会报错,仅修改文件扩展名无法解决。
API质量选项为服务默认、auto、low、medium、high;API尺寸选项为服务默认、auto、1024x1024、1536x1024、1024x1536;输入忠实度选项为服务默认、high、low。这些默认留空,不发送对应选项;其他值需要当前服务和模型支持。
“图片工具模型”用于Responses协议的内部图片模型,留空时由服务器选择;主界面的模型仍需要是能够调用图片工具的主模型。这并非用于在Images协议中同时选择第二个模型。
附加JSON需要是对象;仅填写服务文档中支持的附加参数,不可覆盖model、prompt、image、mask、input、tools、stream、n、messages等主要字段。在Responses中,附加对象位于请求顶层,质量、尺寸及其他设置通过其他控件传给图片工具;透明背景参数也不能与JPEG输出并用。
两个选项卡属于同一个高级对话框,完成设置后应用一次即可。截图中保持默认服务参数和空的附加JSON,最终点击取消返回,未调用图片接口。

8. 实际开始后查看报告并对比结果,根据任务状态恢复
实际确认图片、提示词、接口模型和保存规则后,请点击“开始”。程序会先重新检查使用权限,再扫描并创建任务,之后提交图片编辑。扫描中总数未知时会显示0%和已发现数量,失败、跳过、待确认项也计入处理进度,因此100%并不意味着全部成功。
“停止”会停止新提交并取消网络等待,但正在原子写入的图片会完成保存。已经提交至远程的任务之后仍可能完成并产生费用;同步请求中断后待确认的结果,默认不会自动重新提交。成功图片和任务进度会保留。
需要继续时,请点击“恢复任务”,选择输出目录内的.aitext_jobs/任务编号/queue.sqlite3。原路径、协议、模型、提示词和高级参数会保留,仅新使用当前密钥,当前API基础地址必须与原任务一致;不能用新任务界面的参数覆盖旧任务设置。
加载同类数据库后,“失败重试”会再次尝试失败和待确认项,可能再次产生费用,因此页面会要求确认;成功项不会重做。异步记录已有远程任务ID时,会继续查询该ID,远程任务明确失败或过期时需要创建另一个任务。同一数据库不能由多个实例同时处理,修改输入源图片后需要创建新任务。
完成或停止后,通过“打开结果”查看成品图片目录,通过“任务记录”打开包含最新数据库和报告的目录。结果报告.csv包含输入源、版本、状态、输出路径、错误、提交次数、远程ID,扫描异常会另存为扫描异常.csv;停止大量任务时,报告会先导出最多2000条,但完整状态仍保留在数据库中。
“原图对比”可并排显示输入源和最近的成功结果,也可手动选择两张图片。这是本地查看,不会启动生成;实际使用时需要检查文字、数字、边缘和背景。主界面日志仅保留最近200条,完整任务状态需要查看记录。
此图显示就绪且为0.0%、任务为0/0以及软件已有的启动通知;本次未上传、编辑、下载结果、测试连接、恢复或重试,也未生成图片或任务数据库。

主要参数说明
| 参数 | 功能 | 建议 |
|---|---|---|
| 编辑协议/模型 | Images、Responses图片工具、Sub2API异步。 | 根据服务支持情况选择,将Responses的主模型和工具模型分开。 |
| 提示词模式 | 统一、逐图多版本、逐图CSV。 | 多版本独立处理原图,最多100组。 |
| 保持原有样式 | 默认启用,追加字体、背景等要求。 | 这些是指令,不能替代对结果文字的检查。 |
| 局部选区 | 整个批次共用相对矩形,默认为整图。 | 将版式一致的图片组成批次,局部结果始终恢复至输入源画布尺寸。 |
| 并发数/每分钟请求数 | 1—8,默认值2;0—6000,默认值20。 | 限速仅统计生成提交,0为不限。 |
| 超时/限流重试 | 10—1800秒,默认值300;0—5,默认值2。 | 仅对429/503进行有限次数的重试,超时可能变为待确认。 |
| 输出/JPEG质量 | PNG/JPEG/WebP;60—100,默认值95。 | PNG/WebP为无损编码,JPEG的透明部分会填充白色。 |
| 后缀/命名 | 默认值为_已修改,多版本为_v01等,使用编号避免冲突。 | 即使留空也不会覆盖现有文件。 |
| 不匹配的CSV | 默认跳过,也可回退至统一提示词。 | 回退需要主界面中有非空指令。 |
| 恢复至原图尺寸 | 默认启用,仅控制整图结果的缩放。 | 不会增加细节,局部编辑不受此开关影响。 |
| 上传最长边 | 256—8192,默认值2048。 | 限制提交内容,API尺寸控制生成请求。 |
| 文件/像素限制 | 1—100MB,默认值25;100万—4000万,默认值2500万。 | 原图和上传文件均有文件大小限制,输入图片和返回图片均有像素限制。 |
| API质量/尺寸/忠实度 | 默认为服务默认,不发送附加选项。 | 更改前请确认模型支持情况。 |
| 图片工具模型/附加JSON | 工具模型用于Responses,JSON需要是对象。 | 附加参数不可覆盖图片和提示词的主要字段。 |
结果与保存
成品图片以所选PNG、JPEG或WebP格式写入保存目录,基础名称会添加后缀,多版本还会添加_v01等;冲突时会自动添加编号,不会覆盖输入源或其他成品图片。输入源的EXIF方向会被校正,输出并非输入源元数据的完整备份。
整图默认缩放以恢复至输入源尺寸,局部区域始终贴回原尺寸画布。PNG和无损压缩的WebP保存编码并不意味着AI编辑过程无损,保持原有样式也不能证明文字已经正确。
输出目录的.aitext_jobs下的任务编号目录中会保存queue.sqlite3、结果报告.csv,有时还会保存扫描异常.csv;报告和数据库记录状态,不保存API Key。日志窗口仅包含最近200条,停止大量任务时报告的前2000条并不意味着数据库仅包含这些项。
请通过“打开结果”查看文件,通过“原图对比”查看输入源与输出,通过“任务记录”查看报告。恢复时保留原任务设置,失败重试和待确认项的处理根据页面确认和服务记录决定。
本次使用快速制作模式,所有展示均为素材为空且保持默认参数,未连接API、上传图片、提交编辑、生成或验证成品图片。
常见问题与使用建议
1. 选择New API或Sub2API后就能立即使用吗?
需要填写实际服务地址、密钥、协议和支持图片编辑的模型;预设并非内置账户。
2. 通过连接测试就能证明文字修改模型可用吗?
不能,这仅进行/models查询和认证,不生成图片,也不能证明编辑权限;部分服务也不公开此端点。
3. 多版本会连续修改上一阶段的结果吗?
不会,各提示词组独立作用于同一张原图,用独立行的---分组,最多100组。
4. 为什么CSV提示词被跳过?
不匹配项默认跳过;请检查path的优先级;仅文件名会匹配各目录中的同名图片,需要区分时请使用完整路径或相对路径。
5. 包含逗号的CSV提示词应如何填写?
请使用标准CSV双引号包围,表头为path和prompt各一列且不重复,并使用UTF-8。
6. 局部选区能自动找到每张图片的文字位置吗?
不能,相同的相对矩形会应用于整个批次,不同版式需要分批设置。
7. 上传最长边和恢复至原图尺寸有什么区别?
前者缩小发送给模型的内容,后者缩放返回的整图结果;恢复不会增加细节,局部结果始终保持原尺寸。
8. 为什么100%时仍有失败或待确认项?
失败、跳过、待确认项均计为已处理;请结合报告查看各状态数量,而非只看进度条。
9. 停止后恢复,会自动重新提交所有不确定的请求吗?
普通恢复不会自动重新提交同步待确认项,但“失败重试”会再次尝试这些项,并警告可能产生费用;异步任务有ID时会继续查询。
10. 修改主界面参数后,旧任务恢复时会使用它们吗?
不会,旧数据库保留原设置,仅读取当前密钥并检查API地址是否相同;更改输入源、指令或模型时,需要创建新任务。




