---
canonical: 'https://htmlcsstoimage.com/features/batch-images-for-ai'
title: 'Batch Image API for AI Agents | HTML/CSS to Image'
description: 'Give AI agents several screenshots in one API response. Generate viewport, orientation, color scheme, and content variants from shared defaults.'
---

# Give agents several screenshots in one request

Send one source with a list of viewport, color scheme, or content changes, then return every rendered image together for model analysis or human review.

## Key capabilities

- Multiple screenshots
- Viewport and color scheme variants
- One JSON response

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

## Reduce tool calls for visual checks

### Viewport checks

Render the same page or generated content at several dimensions before selecting an image.

### Candidate comparison

Return a set of rendered candidates for vision-model evaluation or human review.

### Orientation testing

Check portrait, landscape, mobile, and desktop layouts without separate API calls.

### Before-and-after evidence

Capture several visual states together so an agent can compare expected and actual results.

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