进阶 docs.ideogram.ai 2026-11-19 18:13:22 · 7 阅读

第9章 Ideogram 批量生成指南

第9章:批量生成

在 Ideogram 批量生成中,一次最多可运行 500 行提示词(源自 CSV 或电子表格)。系统会统计图像数量、修复文件错误,并允许下载部分或最终结果。

批量生成可将电子表格中的提示词转化为图像。上传文件、确认费用后,即可在批量运行期间继续使用 Ideogram。任务完成后,你会收到通知。

适用对象 任何账户只要积分充足,均可使用批量生成;每一行的计费方式与在应用中单独生成相同。详见“套餐与积分”。

文件类型与限制 格式:.csv、.xls、.xlsx 或 .ods 大小:最大 1 MB 行数:最多 500 行提示词,外加一行表头 每一行提示词对应一次生成任务。`num_images` 列决定该行生成的图像数量。

500 行限制意味着 500 张图吗? 不是。限制的是 500 行提示词(不含表头)。图像总数取决于各行 `num_images` 的总和。例如,10 行设置 `num_images` 为 4,则请求 40 张图。批量生成每行仅支持 1–4 张图;请勿将 Image 应用中 1–8 张的设置直接复制到批量文件中。

模板列 请基于模板开始编辑。“简易”模板涵盖基础项,“完整”模板包含所有列。其中仅 `prompt` 为必填项。其他单元格若留空,将使用默认值。

列名 | 是否必填 | 允许值 | 默认值 --- | --- | --- | --- prompt | 是 | 你的提示词文本 | 无 model | 否 | 2a、2.0、3.0、4.0、auto 或自定义模型的 id/名称 | 3.0 num_images | 否 | 1 到 4 | 4 aspect_ratio | 否 | 宽高比(如 16:9、2.40:1)、auto、landscape(横屏)、portrait(竖屏)、square(正方形) | 无 magic_prompt | 否 | off、auto、on | auto visibility | 否 | private、public | private rendering | 否 | turbo、default、quality | default seed_number | 否 | 数字 | 无 negative_prompt | 否 | 描述图像中需排除的内容 | 无 style | 否 | 风格值;对 4.0 行无效 | auto color_palette | 否 | 预设色板名称,或最多 5 个以空格分隔的 hex 色值 | 无

对于 4.0 模型,请在提示词中描述视觉效果,而非使用 `style` 列。如果 4.0 行包含 style 设置,审核界面会发出警告。 系统会检查自定义模型标识符的访问权限,并将其解析为该模型的基座。标准自定义模型工作流通常使用 Ideogram 3.0,但请勿假设 Image 应用中的所有模型或设置都适用于批量生成。详见“自定义模型”。

支持的模型 批量生成支持 Ideogram 2.0、2a、3.0、4.0 以及 auto。Ideogram 1.0 已退役,使用 1.0 的文件会被拒绝。自定义模型行还需要兼容的模型访问权限及订阅支持。如果验证报告“Custom style requires an enterprise plan(自定义风格需要企业版套餐)”,则该行在当前套餐下无法运行;请更改模型或使用符合条件的企业版工作区。

警告 批量生成不支持 Ideogram 4.5、合作伙伴模型(如 GPT Image、Nano Banana)或视频生成。如需使用这些功能,请使用 Image 应用或 Video 应用。

格式建议 保持表头与模板列名一致。 上传前删除示例行。 将 CSV 文件保存为 UTF-8 编码。 在电子表格应用中,将单元格格式设为“文本”,以防止 2:3 这类值被自动转换为日期。

小型 CSV 示例 prompt, model, num_images, aspect_ratio A watercolor fox in a snowy forest, 3.0, 2, 1:1 A minimal blue coffee cup illustration, 3.0, 1, 4:3 此文件包含 2 行提示词,共请求 3 张图像。这仅为格式示例;提交自有文件前,请使用下载的模板并审核费用。

为什么我的电子表格被拒绝了? 请阅读验证错误,修正源电子表格,然后重新上传或选择“替换”。若有大量错误,错误面板仅显示前五个,修复这些问题后可能会发现其他需要关注的行。 错误会阻止提交;而警告仅描述有效行中被忽略的设置。例如,Ideogram 4.0 行上的 Style 值会被忽略。开始前,请同时检查“首行预览”和“批量汇总”。 某些设置在批量生成中的支持范围可能比交互式 Image 应用更窄。例如,自定义模型行不支持 color palette。请遵循该行模型的报错提示,不要假设模板中的每一列都适用于所有模型。

运行批量任务 1. 打开批量生成:在侧边栏的“更多”部分选择“Batch”。 2. 下载模板:选择“Download template”,然后选择“Simple template”或“Full template”。 3. 填入提示词:每行填写一个提示词,并保存文件。 4. 上传文件:选择“Upload spreadsheet”。若要更换文件,选择“Replace”。 5. 审核批量任务:在“Review your batch generation”页面,检查“First row”和“Batch summary”。 6. 启动批量任务:选择“Start batch generation”或“Cancel”返回。 7. 确认:当出现“Batch submitted”时,选择“Got it”。

费用 “Batch summary”显示生成次数(含图像数)、所需优先积分及可用优先积分。批量功能仍称其为“优先积分”,但这些积分与其他地方相同。费用取决于模型、行数及 `num_images`。详见“积分工作原理”。 提交批量任务至少需要 2 积分;企业版套餐跳过此检查。若中途积分耗尽,批量任务将停止。

恢复停止的批量任务 - 补充积分。 - 在批量生成页面选择“Resume”。 - 在团队版套餐中,仅团队拥有者可购买更多积分。详见“购买额外积分”。

结果与下载 批量生成页面列出你的任务,包括“文件名”、“提交时间”和“状态”(进行中、已完成或已停止)。使用“Stop”终止运行中的任务,使用“Resume”重新启动。

能否在批次完成前下载? 可以。一旦批次产生输出,即使状态为“进行中”、“已停止”或“已完成”,“Download”按钮也可能可用。部分 ZIP 文件仅包含当前已有的结果。下载操作不会终止生成任务。如需稍后完成的图像,可稍后再次下载。 若尚无任何输出,下载按钮将被禁用。在后台准备 ZIP 文件的流程中,进度指示器或“等待”倒计时也可能暂时禁用该按钮。请等待准备完成,不要反复启动同一下载;若应用提示准备失败或超时,再重试。

下载已完成的批次 1. 在批量生成页面找到状态为“Done”的批次。 2. 选择“Download”。你将获得一个名为“Ideogram Batch Download - [你的文件名]”的 zip 文件。 3. 当批次状态显示“Done”时,点击下载按钮。

通过 API API 没有专门的批量端点。请按照《构建可靠的生产集成》中的说明,使用有界并发发送请求。

评论 (0)