Using proxy_id

Route an image render through your own HTTP proxy.

How it works

The proxy_id parameter tells the API to route all outbound traffic for this render through one of the proxies you’ve configured in the dashboard at https://htmlcsstoimage.com/dashboard/proxies.

This is commonly used to:

Allowlist a single egress IP on a private origin.
Get past bot detection on the target site.
Make requests appear from a specific region.

For setup instructions, supported fields, and bypass-host behavior, see the full HTTP Proxies guide.

Value

Type	Description
`String`	The `id` of a proxy you’ve created in the dashboard.

Example usage

JSON request

{
  "url": "https://internal.example.com",
  "proxy_id": "your-proxy-id"
}

cURL

curl -X POST https://hcti.io/v1/image \
  -u 'UserID:APIKey' \
  -H 'Content-Type: application/json' \
  -d '{
        "url": "https://internal.example.com",
        "proxy_id": "your-proxy-id"
      }'

HTML/CSS render

{
  "html": "<img src='https://internal.example.com/logo.png' />",
  "proxy_id": "your-proxy-id"
}

Plan availability

Proxies are available on the 10,000 images/month plan or higher.

Disabling a proxy

You can disable a proxy in the dashboard at any time. Existing images keep working — only new renders that pass that proxy_id will be rejected.

Need help?

Talk to a human. Please email us support@htmlcsstoimage.com with any questions and we’ll gladly help you get started.