展开本页目录
开始前准备什么
- 本题公开输入为原创或虚构教学材料，不需要登录第三方平台。
- API步骤需要自己的apizt Key；在模型广场核对当前权限和费用，Key只留在本机。
- 本地处理步骤需要文中注明的Python、FFmpeg或对应工具；本地执行与云API计费分别判断。
- 整理任务表
- 离线检查
- 一张小样
- 继续处理
- 逐张验收
2026-10-24 核验材料；实际执行范围、结果与限制见下方记录。
补充：原有练习资料与下载
Python 3.10+ 标准库，默认离线；串行提交、无自动重试、任务与结果持久化。
每张图片一行；替换示例文件名与提示词，ID 保持稳定。
包含输入限制、输出状态、缓存恢复、显式重发与费用边界。
按任务记录尺寸、主体、标签、文字、视觉验收与实际费用，避免只看 HTTP 成功。
填写保留项、修改区域、构图与留白；先验收一张小样再批量执行。
真实操作、成品与核验记录
两张原创SKU图通过apizt真实改图，分别保留请求、原图、输出和SHA；网络成功与质检分开记录。蓝色样品保留主标签却额外添了小字，必须进入人工复核，不能看到HTTP200就自动发布。
· 按下列具体任务验收API或本地执行；产品原生功能、文件成功与内容质检分别说明。
已取得下列真实结果；仍有内容质量或功能范围需要按本页检查项复核。
- 运行环境
- apizt API；具体型号与参数见每个请求回执；macOS；公开报告不包含凭据
1. 把每行输入固定到清单
保留job_id、input_sha256、prompt和输出目录；不存在的文件在发起网络请求前拒绝。
2. 显式执行两次小样
每行只提交一次，保存receipt与真实PNG；未知提交保留unknown，恢复时不自动重发。
3. 分别审核文件与内容
先核对文件可解码、大小和SHA，再查看标签、包装、颜色及新添文字；人工审核状态和请求成功分开。
这次实际得到什么
- 两次真实图像请求200，旧7项缓存恢复负例继续保留。
- 蓝色结果出现额外小字，已标记review，不冒称商品标识精确保留。
使用这份结果时注意
- 本例教可恢复批处理与质检，非每张结果都可直接商用发布。
这份脚本做什么：一张输入，对应一张结果
脚本固定向 apizt 的 /v1/images/edits 发送 multipart 请求，model=gpt-image-2、n=1。输入为本地 PNG，输出要求 PNG 的 b64_json；不获取远程图片 URL，不并发提交，不把本地串行任务称为官方 Batch API 或批量折扣。
| 环节 | 本脚本处理 | 你需要确认 |
|---|---|---|
| 输入 | CSV、路径边界、PNG 签名与尺寸、输入摘要 | 原图清晰、任务与 SKU 一一对应 |
| 请求 | 固定 HTTPS 接口、串行、每次提交数上限、无自动重试 | 令牌权限、当前通道参数与价格 |
| 结果 | base64 解码、PNG 签名、尺寸、原子保存与摘要 | 完整打开图片、主体与文字验收 |
| 费用 | 只保存数值 usage，billed_usd 为空 | 控制台实际实扣与整批通过率 |
- 环节
- 输入
- 本脚本处理
- CSV、路径边界、PNG 签名与尺寸、输入摘要
- 你需要确认
- 原图清晰、任务与 SKU 一一对应
- 环节
- 请求
- 本脚本处理
- 固定 HTTPS 接口、串行、每次提交数上限、无自动重试
- 你需要确认
- 令牌权限、当前通道参数与价格
- 环节
- 结果
- 本脚本处理
- base64 解码、PNG 签名、尺寸、原子保存与摘要
- 你需要确认
- 完整打开图片、主体与文字验收
- 环节
- 费用
- 本脚本处理
- 只保存数值 usage，billed_usd 为空
- 你需要确认
- 控制台实际实扣与整批通过率
第一步：建立任务表，文件名和 ID 保持稳定
image 相对 --input-root，不能使用绝对路径、上级目录或远程地址。ID 使用英文字母、数字、下划线或短横线。一个 ID 固定对应同一原图、提示词和参数，不能中途改成另一份任务。
- 下载 CSV 里的商品文件名是待替换示例；先放入自己的 PNG。
- 图片分目录保存时，可用 sku-blue/front.png 这样的相对路径。
- 修改了同一 ID 的原图或要求，脚本会停止。保留原记录，另起明确的新任务 ID。
batch-image-jobs.csv
id,image,prompt
sku-blue,sku-blue.png,"保留商品颜色、轮廓、标签、数量与比例。只换为奶油色背景，不添加文字或配件。"
sku-red,sku-red.png,"保留商品颜色、轮廓、标签、数量与比例。只换为浅灰背景，不添加文字或配件。"
本站绘制的内容说明图：CSV 中两个 SKU 是待替换的文件名示例；一个稳定 ID 固定对应原图、提示词和参数，不表示已经生成整批图片。
第二步：离线检查，不读取密钥、不联网
离线模式读取 CSV 和原图，核对签名、路径、任务指纹及已有 manifest。不读取环境密钥、不创建输出文件、不发请求。预览通过只证明任务材料符合脚本要求，不证明图片接口可用。
先运行预览
python3 batch-image-editing.py \
--jobs batch-image-jobs.csv \
--input-root input-images \
--out batch-output第三步：只发一张小样，核对实际文件与实扣
这条命令最多发一次计费请求。默认 size=1024x1024、quality=low；参数是否透传由当前通道验证。既有样例曾出现请求 1024×1024、实收 1254×1254，因此 manifest 记录实际 PNG 尺寸。
先完整打开小样，核对主体、背景、标签和尺寸，再在控制台核对实扣。billed_usd=null 不是免费，usage 也不是账单。
本地安全设置 tokenba_API_KEY 后运行
python3 batch-image-editing.py \
--jobs batch-image-jobs.csv \
--input-root input-images \
--out batch-output \
--run --max-requests 1
python3 -m json.tool batch-output/manifest.json第四步：保留输出目录，继续未提交任务
--max-requests 限定本次最多提交数，默认 1，范围 1–100。保留同一个输出目录，成功任务检查文件摘要后跳过，未提交任务继续；遇到请求异常，本轮停止，不自动重试。
不要删除 manifest 来绕过重复检查。成功文件丢失或被修改时先恢复文件；超时任务先核对控制台。输出目录锁防止同一目录并发提交，强制终止后需先确认进程停止再处理残留锁。
小样验收后继续
python3 batch-image-editing.py \
--jobs batch-image-jobs.csv \
--input-root input-images \
--out batch-output \
--run --max-requests 10状态恢复：保存成功、视觉通过与费用核对分别记录
缓存只保留可解码 PNG 与数值 usage，不保存完整 API 正文、提示词、URL 或错误消息。它是恢复落盘的中间文件；写入结果并持久化状态后清理。保留 CSV、原图、manifest 和最终输出用于复查。
| 状态 | 意味着什么 | 下一步 |
|---|---|---|
| 任务尚无记录 | 还没有发出请求 | 检查后可提交，受本轮次数上限控制 |
| indeterminate | 请求可能已发出，结果或费用未确定 | 默认跳过，先核对记录与可恢复结果 |
| response_received | 有效响应缓存已保存，可能尚未完成 PNG 落盘 | 从本地缓存恢复，不再请求模型 |
| succeeded | PNG 签名、尺寸与文件保存通过 | 跳过模型请求，继续人工视觉与账单核对 |
- 状态
- 任务尚无记录
- 意味着什么
- 还没有发出请求
- 下一步
- 检查后可提交，受本轮次数上限控制
- 状态
- indeterminate
- 意味着什么
- 请求可能已发出，结果或费用未确定
- 下一步
- 默认跳过，先核对记录与可恢复结果
- 状态
- response_received
- 意味着什么
- 有效响应缓存已保存，可能尚未完成 PNG 落盘
- 下一步
- 从本地缓存恢复，不再请求模型
- 状态
- succeeded
- 意味着什么
- PNG 签名、尺寸与文件保存通过
- 下一步
- 跳过模型请求，继续人工视觉与账单核对
本站绘制的内容说明图：这三个状态分别表示请求不确定、可本地恢复、文件保存通过；succeeded 不自动代表画面质量或费用已经验收。
确实需要重发时，指定任务并确认可能新增费用
这里只允许重发已有的未完成任务，成功任务不能通过这个开关再提交。存在缓存时先恢复或检查缓存；不能因为网络超时、HTTP 错误或结果解码失败就判断没有生成、没有扣费。
仅在核对控制台与已有结果后使用
python3 batch-image-editing.py \
--jobs batch-image-jobs.csv \
--input-root input-images \
--out batch-output \
--run --resume-job sku-blue \
--acknowledge-new-charge --max-requests 1已完成的是离线验证，批量画面需要你的小样验收
本脚本的本地测试覆盖离线不联网、成功后跳过、超时不重发、缓存无新请求恢复、输入变更停止、文件缺失停止、目录边界和敏感字段不落盘。使用本地 PNG 与模拟响应，没有发起批量计费请求。
页面图片是既有实测换背景样例。批量吞吐、通过率、每张实际费用和你的商品一致性没有在本批次在线测量，先按单张小样确认。
怎样确认已经完成
- 先离线检查，再发一张小样。
- 同一 ID 的原图、提示词与参数不变。
- 保留 manifest 与成功输出，超时状态不自动重发。
- 按人工通过数和整批实扣核对成本。
常见问题
批量改图API这次真实做到了什么？
两张原创SKU图通过apizt真实改图，分别保留请求、原图、输出和SHA；网络成功与质检分开记录。蓝色样品保留主标签却额外添了小字，必须进入人工复核，不能看到HTTP200就自动发布。
是否需要登录第三方平台？
本页主流程按上方实测中的apizt API或本地工具执行。本例教可恢复批处理与质检，非每张结果都可直接商用发布。