HTML to Image is a service that converts HTML and CSS into images or captures screenshots of web pages.
HTML to Image is a service that converts HTML and CSS into images or captures screenshots of web pages. On Nagent, HTML to Image is exposed as a fully-configurable images & design integration that any agent can call — 3 actions, and API key authentication. No code is required to wire HTML to Image into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use HTML to Image to automate the kinds of tasks images & design teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire HTML to Image into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against HTML to Image, with input parameters and output schema. Drop these into any step of an agent built in Helix.
HTML_TO_IMAGE_CHECK_USAGEAttempts to retrieve account usage statistics from the HTML-to-Image API by trying multiple common endpoint patterns. NOTE: The html2img.com API does not officially document a dedicated usage statistics endpoint. This action tries several plausible endpoint paths and returns empty usage data if none are found (when return_defaults_on_error=true). For actual usage tracking with html2img.com, monitor the 'credits_remaining' field returned in responses from the convert or screenshot endpoints. Returns hourly, daily, and monthly image creation counts if a usage endpoint exists, or empty statistics as a fallback.
Input parameters
Optional custom endpoint paths to try for usage statistics (e.g., \['/v1/usage', '/api/stats'\]). Supports both relative paths (e.g., '/v1/usage') and fully-qualified URLs (e.g., 'https://api.example.com/usage'). If not provided, the action tries built-in candidates: /v1/usage, /api/usage, /v1/account/usage, /api/account/usage.
If true (default), returns empty usage statistics when no endpoint is found or all endpoints fail. If false, raises an error with details about which endpoints were tried. Recommended to keep as true for graceful handling when the API provider doesn't support usage endpoints.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HTML_TO_IMAGE_CONVERT_TO_IMAGETool to convert HTML content into an image. Returns either a downloadable file or a JSON payload containing id and url, depending on the upstream API behavior.
Input parameters
HTML content to render into an image
Width of the output image in pixels; must be >=1 Maximum enforced limit may apply; exceeding it can cause validation errors or silent downscaling.
Height of the output image in pixels; must be >=1 Maximum enforced limit may apply; exceeding it can cause validation errors or silent downscaling.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HTML_TO_IMAGE_GET_IMAGERetrieve a previously generated image by its URL. Use this to fetch, resize, or download an existing HTML-to-image asset. The image URL is typically obtained from the 'url' field of the HTML_TO_IMAGE_CONVERT_TO_IMAGE response.
Input parameters
Set to 1 to serve the image as a downloadable attachment.
Optional DPI metadata for the image; maximum 600.
Optional output width in pixels; maximum 5000.
Optional output height in pixels; maximum 5000.
Full URL of the generated image (e.g., 'https://i.html2img.com/image-1234567890-123456.png'), typically obtained from the 'url' field of the HTML_TO_IMAGE_CONVERT_TO_IMAGE response. You may also provide just a partial path or append .png, .jpg, or .webp to select the format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 69 agents privately built on Nagent that already use HTML to Image.
Build on Nagent
Connect HTML to Image to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find HTML to Image, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, HTML to Image is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once HTML to Image is connected, you configure its 3 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop HTML to Image steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a HTML to Image event fires, the agent kicks off automatically.
Every HTML to Image action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While HTML to Image ships with 3 pre-built images & design actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching HTML to Image together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build HTML to Image-based workflows tailored to your business.