Batch images for education

Generate personalized classroom materials in one request

Start with shared content and design settings, then create the version each class, student, schedule, or assessment needs.

Start free Read the batch API docs
  • Quiz variations
  • Report card batches
  • Class schedule sets
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

Create every required classroom version together

Read the batch API docs

Mixed quiz versions

Reorder or replace questions while keeping every assessment visually consistent.

Personalized report cards

Generate student summaries from one maintained report layout.

Class schedules

Create schedules for several classes, rooms, or students in one batch request.

Learning material variants

Produce differentiated worksheets and visual aids from shared design settings.

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

Marketing

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

View workflow