Batch Generation

Save time and create images in bulk with Batch generation. Simply upload a spreadsheet with your prompts and settings, then come back to finished images. Only available on Ideogram Pro and Ideogram Team.

Using Batch Generation

1. Click the Batch icon in the left-side panel.

2. Click Download template to download a simple template that you can fill out. You can download the full template instead by clicking on the right-arrow to reveal a dropdown.

Select which template you want to download.

1. Following the template, fill in the rows of the spreadsheet with your prompts and parameters, using the expected values for each column. Be sure to remove the example rows.

There is a limit of 500 rows per uploaded file, including the header row.

1. When finished, save the file. If possible, save it in the CSV UTF-8 (comma delimited) format. This will help with errors in case your file contains special characters.

2. Upload it to Ideogram by clicking Upload spreadsheet in the Batch Generation page. We accept .csv, .xls, and .xlsx formats.

3. Check for error messages. If any appear, make the necessary changes and upload the file again.

Example of an error message.

1. Once there are no errors, review the details of your uploaded CSV file. You will see:

   1. A textual preview of the first row.

   2. The number of rows and images to be generated.

   3. The number of Priority credits required to generate all the images.

   4. The amount of Priority credits available.

If needed, click the Replace button in the upper right corner to upload a different file.

1. Click Start batch generation to begin generating the images. The status and progress will appear in a list below. Since the process may take some time, you can continue using Ideogram or come back later. A notification will be sent once the generation is complete.

The notification message when the Batch Generation is complete.

You can stop the generation at any time by clicking the Stop icon at the right end of the status row. If you have a batch that was stopped before being completed, you can resume it by clicking the "Resume" button. You can also download the images that were already generated in the process by clicking the "Download" button. The images will be downloaded as a compressed .zip file.

1. Once the process is complete, you can download all generated images by clicking the Download icon at the right end of the status row. The images will be downloaded as a compressed .zip file. There should be 4 images generated for every row in the CSV file.

   Alternatively, you can view all the generated images in the Creations section of the website.

The download icon is located at the right end of the status row.

Expected values

The expected values are shown below:

Column	Expected values	Default value
prompt	Any text *Required
visibility	public, private *Required
aspect_ratio	Pre-defined aspect ratio, ex.: 16:9. See Aspect Ratios	1:1
magic_prompt	on, off	on
model	3.0, 2.0, 2a, 1.0	2.0
num_images	Any whole number from 1 to 4	4
seed_number	Any whole number from 0 to 2147483647
rendering	default, turbo, quality	default
negative_prompt	Any keywords separated by commas
style	3.0: auto, general, realistic, design 2.0: auto, general, realistic, design, 3d, anime 1.0: Same as 2.0. Write v1.0 keywords in the prompt.	auto
color_palette	*Only for model 2.0 and higher Up to 5 hexadecimal RGB values separated with spaces. Ex.: #CBA324 #F86C14 #C71E71 or any pre-defined Color palette name: ember, fresh, jungle, magic, melon, mosaic, pastel, ultramarine

If there is a defined default value for a specific column, this value will automatically be applied if nothing is entered.

Useful tips

1. If you are seeing a general "Sorry, something went wrong" error when uploading your CSV file, try saving your file in the CSV UTF-8 (comma delimited) format.

2. Make sure the names in the header row (first row) are entered exactly as in the template file or as described above. Do not change the capitalization.

3. The capitalization of words (except the header row) does not matter.

4. The order of the columns does not matter.

5. When editing the file, make sure the cells are in text format. The automatic formatting might interfere with writing some values. For example, entering a new aspect ratio might be interpreted as a date/time format, causing the value to be rewritten and invalidated. For instance, 2:3 might be rewritten as 2:03.

Combining Ideogram Batch Generation with other AI tools

Did you know that you can combine the power of Ideogram Batch Generation with other AI tools to efficiently iterate and inspire new design concepts?

Here’s an example:

Goal: Generate a variety of Christmas stickers.

Let’s pretend you want to create nice-looking Christmas sticker designs. We will use ChatGPT in this example.

1. Download a CSV template file from the Batch Generation page.

2. Ask ChatGPT to produce a CSV file following the same structure.

3. Provide instructions to ChatGPT, including:

   1. A clear design task.

   2. A few effective prompt examples that work for you.

   3. The settings you want/need (the other column values).

4. Upload the template to ChatGPT along with your instructions (see the example below).

5. Download the CSV file generated by ChatGPT.

6. Upload it to the Batch Generation page. Ideogram will handle the rest.

Here’s an example of what can be sent to ChatGPT as instructions:

Task: Generate a CSV file with 20 prompts following the template of the provided CSV file.

Context: The prompts will be used to create sticker designs for the Christmas Holidays. Ensure the prompts are diverse, creative, and engaging.

Settings: Use 1:1 aspect ratio, set visibility to private, model to 2.0, rendering to "default", magic prompt to "on" and use "design" as style.

Please follow the language style of the following examples:

1- A sticker design of a cartoon-like figure with a cheerful expression holding a brain upright. The figure is standing on a cloud. There is a speech bubble above its head that reads, "HEY, YOU DROPPED THIS!".

2- A sticker design of a stylized, cartoon-like depiction of a fox. The fox appears to be curled up, with its tail wrapped around its body. Its eyes are closed, giving it a peaceful or sleepy expression. The fox is predominantly orange with white accents, especially around its muzzle and eyes. The fox is set against a white background.

3- A sticker design of a cute cat with a curious expression peeking out of a cardboard box where it barely fits. The cat is sitting on the edge of the box. The text "If I Fits, I Sits" is written in a quirky font below the cat. The background is white.

4- A sticker illustration of a whimsical and adorable cartoon sloth relaxing in a hammock, hanging between two palm trees on a beach. The sloth is wearing stylish sunglasses and has a relaxed grin. The background contains a serene blue sky, fluffy white clouds, and a few other palm trees.

5- A charming and whimsical sticker design featuring a sleepy owl perched on a book, its eyes half-closed. The background neutral grey and the sticker has a thick white outline.

6- A vibrant, retro-inspired sticker with bold white outlines. The motivational phrase "NEVER GIVE UP!" is written in a dynamic, flowing cursive font reminiscent of 1950s Americana signage. The text has a subtle neon glow. The phrase is surrounded by playful, abstract shapes and vintage-inspired patterns. The overall design is bright, cheerful, and evokes energy and optimism.

Here are some of the resulting images for this example:

You can find more powerful examples and other information in our blog post here.