Curl

Generate a png, jpg or webp images from your terminal with cURL.

Live demo Get an API Key

---

Table of contents

• Generate an image with cURL
• Response
• Advanced example
• Loading in contents from a file
• Need help?

Generate an image with cURL

Run this command in your terminal to generate an image using the API.

For more details on how this works, see Creating an image.

# Replace UserID and APIKey with your credentials from the dashboard https://htmlcsstoimage.com/dashboard
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey'\
     -d html="<div class='ping'>Pong ✅</div>" \
     -d css=".ping { padding: 20px; font-family: 'sans-serif'; }"

Response

The API will return a json payload with the URL to your new image.

{ "url":"https://hcti.io/v1/image/1eecf460-e2e5-4db1-9db6-cf862c34a744" }

Advanced example

Here we use additional parameters. Note that each line ends with a \.

# Replace UserID and APIKey with your credentials from the dashboard https://htmlcsstoimage.com/dashboard
curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey'\
     -d html="<div class='ping'>Pong ✅</div>" \
     -d css=".ping { padding: 20px; font-family: 'sans-serif'; }" \
     -d ms_delay=1000 \
     -d selector=".ping"

Loading in contents from a file

In this example, we grab the contents of a local HTML file and pass them in to the html param.

The cat command outputs the content of the file. By wrapping this in $() we are able to get the HTMl included in the payload.

curl -X POST https://hcti.io/v1/image -u 'UserID:APIKey'\
     -d html="$(cat path/to/file.html)" \
     -d css=".ping { padding: 20px; font-family: 'sans-serif'; }"

---

Need help?

Talk to a human: support@htmlcsstoimage.com. We always respond within 24 hours. And often, even faster.

---