docs/llms.txt at main · htmlcsstoimage/docs · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# HTML/CSS to Image API

> API for converting HTML and CSS to high-quality images (PNG, JPG, WebP, PDF). Renders exactly like Google Chrome.

## Quick Start

- **Endpoint:** `POST https://hcti.io/v1/image`
- **Authentication:** HTTP Basic Auth (User ID + API Key)
- **Get credentials:** https://htmlcsstoimage.com/dashboard

## Example Request

```bash
curl -X POST https://hcti.io/v1/image \
  -u 'your-user-id:your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{"html": "<div style=\"padding:20px;background:#4f46e5;color:white;\">Hello World</div>"}'
```

## Response

```json
{
  "url": "https://hcti.io/v1/image/be4c5118-fe19-462b-a49e-48cf72697a9d",
  "id": "be4c5118-fe19-462b-a49e-48cf72697a9d"
}
```

## Capabilities

- Convert HTML/CSS to images (PNG, JPG, WebP, PDF)
- Screenshot any public URL
- Batch create up to 25 images in one request
- Reusable templates with variable substitution
- MCP Server integration for AI assistants (Cursor, Claude, Windsurf)
- HTTP proxy support for routing render traffic through your own proxy
- Global CDN delivery via Cloudflare

## Key Parameters

| Parameter | Description |
|-----------|-------------|
| `html` | HTML to render (required unless using `url`) |
| `css` | CSS styles for your HTML |
| `url` | URL to screenshot (required unless using `html`) |
| `google_fonts` | Google Fonts to load |
| `device_scale` | Pixel ratio (1-3) for retina images |
| `viewport_width` | Browser viewport width |
| `viewport_height` | Browser viewport height |
| `selector` | CSS selector to capture specific element |
| `ms_delay` | Milliseconds to wait before capture |
| `jumbo_max_width` | Max output width for jumbo renders (up to 80,000px). Must be set with `jumbo_max_height`. |
| `jumbo_max_height` | Max output height for jumbo renders (up to 80,000px). Must be set with `jumbo_max_width`. |

## Documentation

- **API Reference:** https://docs.htmlcsstoimage.com/getting-started/using-the-api/
- **Code Examples:** https://docs.htmlcsstoimage.com/example-code/
- **Parameters:** https://docs.htmlcsstoimage.com/parameters/
- **MCP Server:** https://docs.htmlcsstoimage.com/integrations/mcp/
- **TypeScript Client (npm):** https://docs.htmlcsstoimage.com/example-code/typescript/
- **HTTP Proxies:** https://docs.htmlcsstoimage.com/guides/advanced/proxies/
- **Jumbo Images:** https://docs.htmlcsstoimage.com/guides/advanced/jumbo-images/
- **FAQ:** https://docs.htmlcsstoimage.com/faq/

## Integrations

- **Zapier:** https://docs.htmlcsstoimage.com/integrations/zapier/
- **Make:** https://docs.htmlcsstoimage.com/integrations/make/
- **MCP Server:** https://docs.htmlcsstoimage.com/integrations/mcp/
- **TypeScript Client (npm):** https://docs.htmlcsstoimage.com/example-code/typescript/

## Code Examples Available

Python, PHP, JavaScript, TypeScript, Ruby, Go, C#, VB.NET, cURL, Google Apps Script

## Support

Email: support@htmlcsstoimage.com