For the complete documentation index, see llms.txt. This page is also available as Markdown.

Batch Generation

Batch Generation lets you create many generations from a spreadsheet of prompts and settings.

Batch Generation is available where your plan and account support it, typically on Pro and Team plans.

Upload a .csv, .xls, .xlsx, or .ods spreadsheet up to 1 MB. A batch can include up to 500 prompt rows plus one header row. Each prompt row becomes one generation, and num_images controls how many images each generation creates.

How to Use Batch Generation

  1. Open Batch under the Tools section in the Navigation Bar on the side (desktop) or bottom (mobile).

  2. Download the simple or full template.

  3. Fill in the spreadsheet using supported columns and values.

  4. Upload the spreadsheet.

  5. Review the preview, total generations, image count, and required Priority credits.

  6. Start the batch.

  7. Return to the Batch page to review progress, stop or resume supported jobs, and download completed results as a ZIP file.

Batch Generation page with an arrow to Batch in the sidebar and two completed jobs listed at 100% with Done status

Generated images are also available from your Library where your account and current product surface support them.

Template Columns

The full template can include these columns:

Column
Purpose

prompt

Text prompt for the generation.

visibility

Public/private visibility where private generation is supported.

aspect_ratio

Aspect ratio such as 1:1 or 16:9.

magic_prompt

Magic Prompt setting.

model

Model label supported by the batch workflow.

num_images

Number of images for each prompt row.

seed_number

Seed value where supported.

rendering

Render speed where supported by the model.

negative_prompt

Terms or concepts to avoid where supported.

style

Style setting where supported.

color_palette

Preset or custom color palette where supported.

If a column has a default in the template or product flow, Ideogram applies that default when the cell is left blank.

Formatting Tips

  • Keep the header row exactly aligned with the template column names.

  • Remove example rows before uploading your file.

  • Save CSV files as UTF-8 when possible.

  • In spreadsheet apps, format cells as text to prevent values such as 2:3 from being converted to dates.

  • If upload validation fails, fix the highlighted rows or columns and upload again.

Credits

Batch Generation uses Priority credits. Credit usage depends on the selected model, render speed, number of prompt rows, and num_images value.

For current plan and credit details, see Available Plans and ideogram.ai/pricing.

Last updated