Skip to content

Docs

API docsOpen Ideogram

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.

ColumnRequiredAllowed valuesDefault
promptYesYour prompt textNone
modelNo2a, 2.0, 3.0, 4.0, auto, or a custom model's id or name3.0
num_imagesNo1 to 44
aspect_ratioNoW:H such as 16:9 or 2.40:1, auto, landscape, portrait, squareNone
magic_promptNooff, auto, onauto
visibilityNoprivate, publicprivate
renderingNoturbo, default, qualitydefault
seed_numberNoA numberNone
negative_promptNoWhat to leave out of the imageNone
styleNoA style value; ignored for 4.0 rowsauto
color_paletteNoA preset palette name, or up to 5 hex codes separated by spacesNone

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.

Warning

Batch does not support Ideogram 4.5, partner models such as GPT Image or Nano Banana, or video. Use the Image app or Video app for those.

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:3 don'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:3

This 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

  1. Open Batch

    In the sidebar's More section, select Batch.

  2. Download a template

    Select Download template, then choose Simple template or Full template.

  3. Fill in your prompts

    Fill in one prompt per row and save the file.

  4. Upload the file

    Select Upload spreadsheet. To swap the file, select Replace.

    Review your batch generation header with the file name and the Replace button highlighted

    Select Replace to swap the file.

  5. Review the batch

    On Review your batch generation, check the First row and the Batch summary.

    Review your batch generation card with the First row and Batch summary panels highlighted

    Check the First row and the Batch summary.

  6. Start the batch

    Select Start batch generation, or Cancel to go back.

    Batch summary panel with the Start batch generation button highlighted

    Select Start batch generation.

  7. 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

  1. Add credits.
  2. 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

  1. On the Batch Generation page, find a batch whose Status reads Done.

  2. Select Download. You get a zip file named "Ideogram Batch Download - " plus your file name.

    Batch history table with File name, Submitted and Status columns; the first row's Done status and download button are highlighted

    When a batch reads Done, select the download button.

In the API

The API has no batch endpoint. Send requests with bounded concurrency, as Build a reliable production integration describes.