proxy_id

Route an image render through your own HTTP proxy.

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.

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

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": "<img src='https://internal.example.com/logo.png' />",
  "proxy_id": "your-proxy-id"
}

Create or inspect proxies through the Management API or MCP tools. Using an existing proxy for image creation requires image permissions; editing its configuration requires proxy management permissions.