---
canonical: 'https://htmlcsstoimage.com/features/batch-images-for-developers'
title: 'Batch Image API for Developers | HTML/CSS to Image'
description: 'Generate image variants from one baseline request. Test viewports, timezones, color schemes, and full-page captures without separate API calls.'
---

# Generate a browser-state matrix in one request

Send shared content once, then override viewport, timezone, color scheme, or full-page capture for each image in the batch.

## Key capabilities

- Viewport matrices
- Color scheme and timezone variants
- Per-image overrides

## Generate multiple images with one batch API request

Send shared content and rendering settings to `POST https://hcti.io/v1/image/batch` in `default_options`, then add the overrides for each image in `variations`. Each variation supports the same controls as an individual image request.

```json
{
  "default_options": {
    "url": "https://example.com"
  },
  "variations": [
    { "viewport_width": 1200, "viewport_height": 630 },
    { "viewport_width": 630, "viewport_height": 1200 },
    { "color_scheme": "dark" }
  ]
}
```

The batch image API returns every generated image URL together, without requiring your application to coordinate several nearly identical requests. Each variation is a separate image generation for usage purposes, and the maximum number of variations depends on the account.

## MCP Integration

Connect an MCP-compatible client to `https://mcp.hcti.io` with OAuth. The tools use the connected organization's HTML/CSS to Image account, permissions, and plan limits.

- The `get_max_batch_size` tool returns the maximum number of images the account can include in one batch.
- The `create_batch_images` tool accepts shared defaults and per-image overrides, then returns the generated image results together.

[Read the full MCP docs](https://docs.htmlcsstoimage.com/integrations/mcp/).

## Add batch screenshot generation to your product

### Responsive viewport matrices

Capture a page across the viewport sizes your application officially supports.

### Color-scheme testing

Render light and dark modes together to find missing styles or inconsistent states.

### Timezone-sensitive pages

Check dashboards, schedules, and date-driven interfaces across target timezones.

### Release screenshots

Attach the same set of page states to deploys, test runs, and pull-request reviews.

## Get started

REST API requests require an HTML/CSS to Image account and should be authenticated from trusted application code. Check the API docs and pricing for current setup instructions, limits, and feature availability.

- [View the full feature page](https://htmlcsstoimage.com/features/batch-images-for-developers)
- [Browse all features](https://htmlcsstoimage.com/features.md)
- [Start free](https://htmlcsstoimage.com/join)
- [View pricing](https://htmlcsstoimage.com/pricing.md)
- [Read the batch API docs](https://docs.htmlcsstoimage.com/getting-started/using-the-api/#batch-image-creation)
- [Read the MCP docs](https://docs.htmlcsstoimage.com/integrations/mcp/)