Batch image generation API

Generate multiple images in one API request

Set content and rendering options once in default_options, add only the changes for each variation, and receive every image URL in one response.

Start free Read the batch API docs
  • One batch API call
  • Shared default options
  • Per-image overrides
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.

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"
    }
  ]
}

Use cases

Create complete image sets without repeated API calls

Read the batch API docs

Responsive screenshot sets

Create desktop, mobile, portrait, and landscape captures from the same source.

Browser-state variants

Render light and dark modes, timezones, or other browser settings together.

Personalized image sets

Generate related images for several audiences, locales, or content variations.

QA and approval sets

Produce every required image together for visual comparison, testing, or approval.

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

Marketing

Generate channel sizes, audience variants, and localized campaign images together.

View workflow

Education

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

View workflow