切换主题
批量生图与结果下载
批量生图适合一次处理多条提示词、为同一提示词生成多个结果，或统一下载一组图片。它与普通 AI 生图工作台是两个独立功能：普通生图适合单次创作，批量生图适合排队执行和集中管理结果。
开始前准备
- 后台当前已开启批量生图功能。
- 已创建一把所属分组开启批量生图的 Gemini API Key。
- 该 Key 下至少有一个可用批量生图模型。
- 账户余额足以冻结本次任务预计费用。
- 需要参考图时，文件为 10 MB 以内的 PNG、JPEG 或 WebP。
普通生图 Key 不一定能用于批量生图
批量生图页面只会列出符合条件的 Gemini API Key 和模型。Key 在普通文本或生图接口可用，不代表它的分组已经开启批量能力。
1. 打开批量生图页面
登录控制台后，从左侧栏进入“批量生图”。页面上方可按任务名称、API Key、任务状态和下载状态筛选历史任务。
没有记录时，点击右上角“创建批量任务”。
2. 选择 Key 和模型
- 从列表选择已开启批量生图的 Gemini API Key。
- 等待页面加载该 Key 可用的批量模型。
- 选择目标模型。
- 确认当前任务固定按 1K 图片提交。
如果 Key 列表为空，先到分组、可用渠道与倍率和创建和保护 API Key核对分组；如果有 Key 但没有模型，通常需要管理员检查分组、模型、上游账号和批量生图开关。
3. 添加提示词
- 任务名称可以留空，提交时系统会使用当前时间生成名称。
- 在提示词输入框填写一条 prompt。
- 点击添加，把它加入任务列表。
- 为每条 prompt 选择生成张数。
- 继续添加下一条，直到任务内容完整。
数量限制：
- 每条 prompt 最多生成 4 张。
- 一组任务预计输出总数最多 200 张。
- 预计输出数是每条 prompt 的生成张数之和，不是 prompt 条数。
提交前核对预计生成张数
超过 200 张必须拆成多组任务。页面卡顿或正在提交时不要重复点击，否则可能创建重复任务并重复冻结费用。
4. 添加参考图
参考图支持 PNG、JPEG 和 WebP，单个文件最大 10 MB。它会绑定到当前提示词，不是输出图片数量。
当前模型限制：
- Gemini 2.5 Flash Image：每条最多 3 张参考图。
- Gemini 3 Pro Image：每条最多 14 张参考图。
参考图会随该条 prompt 的生成张数重复参与输入处理。大量重复参考图会增加上游输入和任务体积，应拆分任务并压缩图片。
5. 提交和费用冻结
提交前检查：
- Key 和模型正确。
- prompt 列表没有空项。
- 自定义 ID 没有重复。
- 预计输出不超过 200 张。
- 参考图数量、格式和大小符合限制。
- 页面显示的预计冻结费用可以接受。
系统创建任务时会先冻结预计费用。最终按成功输出图片数量结算；失败或未生成部分对应的冻结金额会按系统规则释放。
6. 理解任务状态
| 状态 | 含义 |
|---|---|
| 排队中 | 等待上游开始处理 |
| 生成中 | 正在执行图片生成 |
| 整理结果 | 正在拉取和整理输出文件 |
| 结算中 | 正在核对成功数量和费用 |
| 已完成 | 任务结束，可以查看或下载 |
| 部分成功 | 有成功图片，也有失败明细 |
| 全部失败 | 没有生成可用图片 |
| 已取消 | 已请求取消剩余任务 |
| 结果已删除 | 历史记录仍在，但结果文件已经清理 |
批量任务可能长时间排队或生成。不要高频刷新和重复提交；页面会继续保留任务状态。
7. 查看明细和预览
打开“查看详情”可以看到每条 prompt 的状态。为减少浏览器内存和网络消耗，图片预览不会自动全部加载，需要时再点击单条预览。
页面预览可能是压缩缩略图。需要检查清晰原图时，应下载任务 ZIP。
8. 下载结果
任务完成后：
- 打开任务操作菜单。
- 点击“下载 ZIP”。
- 等待浏览器完成下载。
- 解压后核对文件数量与成功输出数量。
也可以选中多个已完成任务后批量下载。下载请求过多或 ZIP 过大时，应减少单次选择数量后重试。
重要结果应及时下载。任务结果可能按存储策略清理，列表中显示“结果已删除”后将无法重新下载原文件。
9. 只重试失败项
任务部分失败时，使用“重试失败项”，不要重新提交整个任务：
- 打开原任务的更多操作。
- 选择“重试失败项”。
- 核对新建子任务只包含失败明细。
- 等待子任务完成。
如果历史任务没有保留失败项 prompt，系统无法自动重试。此时复制原始 prompt，手动创建新任务。
10. 取消和删除记录
取消任务只会请求停止尚未完成的部分；已经被系统记录为成功的图片仍会结算，其余冻结金额按规则释放。
删除记录会把任务从列表隐藏，但不会删除账务记录。正在生成或结算的任务需要先等待结束或取消，不能直接删除。
常见问题
页面没有可选 API Key
当前没有分组开启批量生图的 Gemini Key。新建或调整 Key 前先确认目标分组和功能开关。
有 Key 但没有模型
该 Key 所属分组没有配置可用批量模型，或上游 Gemini/Vertex 账号不可调度。保留错误码和请求 ID联系管理员。
提示余额不足或费用冻结失败
减少预计输出张数或补充余额。费用冻结失败时任务没有成功提交，不要连续重复点击。
部分图片失败
查看失败明细、错误来源和简要原因，只重试失败项。安全策略、上游单条失败或空图片结果都可能导致部分失败。
任务完成但无法下载
确认结果文件尚未清理，并减少一次下载的任务数量。仍失败时提供任务 ID、错误码和请求 ID。
与其他生图方式的区别
- 单张创作或网页图生图：看AI 生图工作台。
- 在 Codex 中自然语言生图：看在 Codex 中生图。
- 脚本或应用调用图片接口：看直接调用生图 API。
- 多 prompt、重复输出、集中下载和失败重试：使用本页批量生图。