---
canonical: 'https://htmlcsstoimage.com/features/batch-images'
title: 'Batch Image Generation API | HTML/CSS to Image'
description: 'Generate image variations in one batch API request. Set shared defaults, override viewport, color scheme, timezone, or content, and receive all results together.'
---

# 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.

## Key capabilities

- One batch API call
- Shared default options
- 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/).

## Create complete image sets without repeated API calls

### 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.

## 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)
- [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/)