How to Create a Batch of Images

Batches allow you to create multiple images in a single API request. You can submit up to 100 image payloads at once, that may include:

• 100 variations of the same template
• 100 requests across different templates
• 100 different sizes of the same template (if it's responsive)
• 100 batch of different templates / sizes

Post a list of items to the /v5/batches endpoint (https://developers.bannerbear.com/v5/#post-v5-batches). Each item in a batch follows the same schema as Create an image.

Batches with different Template sizes

If you wish to create a batch of different sized images from the same template, create a responsive template using the responsive settings on each layer in your template. These settings will instruct each layer how to behave when the template is resized during rendering

🐻 Bear Tip: Check out "How to Create a Responsive Template" for more

Use the Height and Width parameters to set the size of each item in your batch. These should be nested under modifications → template.

{
"template": "QAYqDP5mwaKGZrkoXa",
"modifications": {
  "template": {
     "width": 1200,
     "height": 630
  },
  "objects": [
     {
        "name": "title",
        "text": "Image 1"
     }
  ]
}
}