控制台批量图片
/batch-image 页面用于一次提交多条图片提示词，并统一查看状态和下载结果。批量图片当前要求 API Key 绑定支持该能力的 Gemini 分组，并且管理员已开启批量图片功能。
创建前准备
- 创建一个绑定目标 Gemini 分组的 API Key。
- 确认该 Key 的状态、余额和周期额度可用。
- 在页面选择 Key 后，从接口返回的可用模型中选择模型。
- 准备每个条目的唯一
custom_id和提示词。
不要手工猜测模型名。模型列表会按当前 Key 和分组能力过滤。
创建任务
任务可配置：
- 任务名称。
- 模型、图片尺寸和宽高比。
- 多个提示词条目。
- 每项输出数量。
- 可选参考图片。
- 用于追踪的唯一
custom_id。
custom_id 用于在结果、错误和下载文件中对应原始业务条目，同一任务内不要重复。大量条目建议从稳定业务 ID 生成，而不是使用数组序号。
提交前页面会展示预估成本和占款。系统先预留一部分 USD 余额，完成后按实际成功结果结算并释放多余占款；预估金额不是最终扣费。
状态说明
| 状态 | 含义 |
|---|---|
queued | 已进入队列 |
running | 服务端正在提交或处理任务 |
indexing / processing_results | 正在索引和整理结果 |
settling | 正在计算实际费用并释放占款 |
completed | 已完成，可查看和下载结果 |
failed | 任务失败，查看条目错误 |
cancelled | 已取消 |
output_deleted | 输出文件已清理，但任务记录仍保留 |
任务列表支持按名称、API Key、状态和是否下载筛选。详情中会分别显示成功数、失败数、预估成本、占款和最终费用。
失败项重试
完成或失败的任务如果存在失败条目，可使用“重试失败项”。系统会创建带 parent_batch_id 的子任务，只复制可重试失败项，并在列表中显示父子关系。成功条目不会再次生成或重复计费。
重试前先查看每项错误：参数或内容问题应先修改提示词；暂时性服务错误才适合直接重试。
下载和清理
- 单项内容：按
custom_id下载某张输出。 - ZIP：下载任务的成功结果和清单。
- 批量下载：选择多个已完成任务分别下载。
- 删除输出：清理对象存储中的结果，但保留任务记录。
- 删除记录：仅终态任务可删除；这不是取消正在执行任务的替代操作。
下载动作会记录时间。结果保留周期由系统配置决定，重要文件应尽快下载到自己的存储。
取消任务
可取消的非终态任务会显示取消操作。取消是尽力而为：目标平台已经开始处理的部分可能仍会产生结果或费用，最终以结算状态为准。
API 对应关系
控制台通过 /v1/images/batches 系列接口工作。直接接 API 时应带 Idempotency-Key，完整请求示例见图片生成、编辑与异步任务。
常见错误
- 模型列表为空：Key 分组不是 Gemini，或分组未开启批量图片。
- 提交后余额不足：预估占款超过可用 USD 余额。
- 部分失败：打开条目详情，按
custom_id排查具体错误。 - 无法下载：任务尚未完成、输出已清理或结果保留期已过。
- 一直停在
settling：记录批次 ID 和时间后提交工单，避免重复创建任务。