Batch Generation
Run up to 500 prompt rows from a CSV or spreadsheet in Ideogram Batch Generation. Count images, fix file errors and download partial or finished results.On this page
Batch Generation turns a spreadsheet of prompts into images. Upload the file, confirm the cost, and keep using Ideogram while the batch runs. You get a notification when it's ready.
Who can use it
Any account with enough credits can use Batch Generation; each row is charged like the same generation in the app. See Plans and Credits.
File types and limits
- Formats: .csv, .xls, .xlsx or .ods
- Size: up to 1 MB
- Rows: up to 500 prompt rows, plus the header row
Each prompt row is one generation. The num_images column sets how many images that row makes.
Does the 500-row limit mean 500 images?
No. The limit is 500 prompt rows, plus the header. Image count is the sum of num_images across those rows. For example, 10 rows with num_images set to 4 request 40 images. Batch accepts 1–4 images per row; don't copy the Image app's 1–8 setting into a batch file.
Template columns
Start from a template. The Simple template covers the basics; the Full template has every column. Only prompt is required. Leave any other cell blank to use its default.
| Column | Required | Allowed values | Default |
|---|---|---|---|
prompt | Yes | Your prompt text | None |
model | No | 2a, 2.0, 3.0, 4.0, auto, or a custom model's id or name | 3.0 |
num_images | No | 1 to 4 | 4 |
aspect_ratio | No | W:H such as 16:9 or 2.40:1, auto, landscape, portrait, square | None |
magic_prompt | No | off, auto, on | auto |
visibility | No | private, public | private |
rendering | No | turbo, default, quality | default |
seed_number | No | A number | None |
negative_prompt | No | What to leave out of the image | None |
style | No | A style value; ignored for 4.0 rows | auto |
color_palette | No | A preset palette name, or up to 5 hex codes separated by spaces | None |
For 4.0 rows, describe the look in the prompt instead of using style. The review screen warns you if a 4.0 row has a style.
Custom-model identifiers are checked for access and resolved to that model's base. The standard custom-model workflow uses Ideogram 3.0, but don't assume that every model or setting available in the Image app is accepted in Batch. See Custom Models.
Supported models
Batch supports Ideogram 2.0, 2a, 3.0 and 4.0, and auto. Ideogram 1.0 is retired, so a file that uses 1.0 is rejected. Custom-model rows also require compatible model access and subscription support. If validation reports Custom style requires an enterprise plan, that row can't run under the current plan; change the model or use an eligible Enterprise workspace.
Formatting tips
- Keep the header row the same as the template's column names.
- Delete the example rows before you upload.
- Save CSV files as UTF-8.
- In spreadsheet apps, format cells as text so values like
2:3don't turn into dates.
Small CSV example
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:3This file has 2 prompt rows and requests 3 images. It is a formatting example; use the downloaded template and review the cost before submitting your own file.
Why was my spreadsheet rejected?
Read the validation errors, correct the source spreadsheet, then upload it again or choose Replace. The error panel shows the first five errors when there are more, so fixing those can reveal additional rows that need attention.
An error prevents submission; a warning can describe an ignored setting on an otherwise valid row. For example, a Style value on an Ideogram 4.0 row is ignored. Check both the first-row preview and the full batch summary before starting.
Settings can have narrower support in Batch than in the interactive Image app. For example, a color palette isn't supported on a custom-model row. Follow the error for that row's model rather than assuming that every template column works with every model.
Run a batch
Open Batch
In the sidebar's More section, select Batch.
Download a template
Select Download template, then choose Simple template or Full template.
Fill in your prompts
Fill in one prompt per row and save the file.
Upload the file
Select Upload spreadsheet. To swap the file, select Replace.

Select Replace to swap the file.
Review the batch
On Review your batch generation, check the First row and the Batch summary.

Check the First row and the Batch summary.
Start the batch
Select Start batch generation, or Cancel to go back.

Select Start batch generation.
Confirm
When Batch submitted appears, select Got it.
Cost
The Batch summary shows Number of generations (with the image count), Priority credits needed and Priority credits available. Batch still says "priority credits"; these are the same credits as everywhere else. Cost depends on the models, the number of rows and num_images. See How credits work.
You need at least 2 credits to submit a batch; Enterprise plans skip this check. If your credits run out midway, the batch stops.
Resume a stopped batch
- Add credits.
- On the Batch Generation page, select Resume.
On a Team plan, only team owners can buy more credits. See Buying Extra Credits.
Results and download
The Batch Generation page lists your batches with File name, Submitted and Status (In progress, Done or Stopped). Use Stop to halt a running batch and Resume to restart it.
Can I download a batch before it finishes?
Yes. Once a batch has produced output, Download can be available while it is In progress, Stopped or Done. A partial ZIP contains the results available at that point. Downloading doesn't stop the generation job. Download again later if you need the images completed after that download.
Download is disabled before any output exists. In download flows that prepare a ZIP in the background, a progress indicator or Wait countdown can also temporarily disable the button. Let preparation finish rather than repeatedly starting the same download; retry if the app reports that preparation failed or timed out.
Download a finished batch
On the Batch Generation page, find a batch whose Status reads Done.
Select Download. You get a zip file named "Ideogram Batch Download - " plus your file name.

When a batch reads Done, select the download button.
The API has no batch endpoint. Send requests with bounded concurrency, as Build a reliable production integration describes.