Batch images for marketing

Generate every campaign image size in one request

Keep shared design settings consistent while changing dimensions, messaging, audiences, or locales for each image in the batch.

Start free Read the batch API docs
  • Channel-specific dimensions
  • Audience and locale variants
  • One approval-ready set
One batch image request producing four coordinated image variations.
POST /v1/image/batch
{
  "default_options": {
    "url": "https://hcti.io"
  },
  "variations": [
    { "viewport_width": 1200 },
    { "viewport_width": 630 },
    { "color_scheme": "dark" },
    { "full_screen": true }
  ]
}

Live demo

Try the batch image API

Set one URL as the default, change the viewport and browser settings for each variation, and receive all three image URLs from one request.

Options

This URL is used as the default for all three variations.
Variation 1
Variation 2
Variation 3

Results

Try a batch image request

Choose one URL and three variations, then generate them with a single API request.

This simplified demo shows a few common controls. See the API reference for every option supported in default_options and individual variations.

Use cases

Generate campaign assets without rebuilding each version

Read the batch API docs

Social and display sizes

Generate portrait, landscape, square, and banner images from one source.

Segment-specific campaigns

Change messaging or content by audience while preserving the same design settings.

Localized campaign images

Produce language and regional variants together in one batch response.

Campaign approval sets

Deliver every required version together for review before publishing.

Baseline + variations

Set shared options once

Put common content and rendering settings in default_options, then include only the overrides each image needs.

01

Set the defaults

Define the URL and any settings shared by every image once in default_options.

"url": "https://example.com"
02

Add per-image overrides

Each variation can change viewport, color scheme, timezone, full-page capture, content, or other image options.

"color_scheme": "dark"
03

Get every image URL

The response returns one generated image result for each variation.

"images": [ ... ]

Batch image API

Generate multiple images with one API call

Send one authenticated request with shared defaults and an explicit list of variations instead of maintaining several separate requests.

  • One batch endpoint

    Generate all variations in one batch instead of coordinating separate API requests.

  • The same image controls

    Use the viewport, browser, content, format, and capture options available to an individual image request.

  • Fewer requests to manage

    Keep shared settings in one place instead of building and tracking several nearly identical API calls.

Batch image API request.
POST /v1/image/batch
{
  "default_options": {
    "url": "https://example.com"
  },
  "variations": [
    {
      "viewport_width": 1200,
      "viewport_height": 630,
      "color_scheme": "light"
    },
    {
      "viewport_width": 630,
      "viewport_height": 1200,
      "color_scheme": "dark"
    }
  ]
}

Ready to generate?

Create your next image set in one request

Set shared defaults, override only what changes, and receive every generated image URL together.

Start free Read the batch API docs

Batch image workflows

Batch image workflows by team

See how teams use shared defaults and per-image overrides for testing, campaigns, agent tasks, and classroom materials.

AI & Agents

Return viewport, orientation, color scheme, and content variants to an agent in one response.

View workflow

Developers

Test viewports, layouts, color schemes, and timezones without coordinating separate calls.

View workflow

Education

Generate quiz versions, report cards, schedules, and learning materials from shared defaults.

View workflow