No browser runtime to maintain
Keep Rails applications and background jobs free of separate browser processes and browser-specific deployment dependencies.
HTML to JPEG with Ruby
Generate JPEG images with Ruby
No browser management required
Render HTML and CSS from Ruby without installing Chrome, running Ferrum or Selenium, or building a separate image-storage pipeline.
- No browser processes to maintain
- Consistent managed Chromium rendering
- Complete Ruby request below
View example
Request
Ruby workflow
Test the render before adding it to Ruby
Adjust the HTML and CSS here, then use the Ruby example below instead of recreating the browser-rendering workflow locally.
Managed rendering
Skip the fragile parts of native Ruby browser automation
Keep the application code focused on the request and response while HCTI manages Chromium, render isolation, retries, and hosted output.
Predictable production rendering
Use managed browser versions, isolated render jobs, built-in timing controls, and consistent viewport behavior across deployments.
A usable image URL immediately
Receive the hosted .jpeg result without building a separate pipeline for temporary files, uploads, storage, and delivery.
HTML to image API
Send one Ruby request instead of running a browser
POST the HTML, CSS, and format from Ruby. HCTI handles the browser lifecycle and returns the generated .jpeg URL.
-
HTML and CSS input
Send complete markup and styles, including browser-supported fonts, images, SVG, and JavaScript.
-
JPEG output
Set format to jpeg and use the hosted .jpeg URL returned by the API.
-
Viewport and crop controls
Set viewport dimensions and device scale, or crop the result to a CSS selector.
-
Page environment
Choose light or dark mode, timezone, and screen or print media.
Request
How it works
From markup to a finished JPEG
-
Send HTML and CSS
Submit the content with format set to jpeg and any viewport or browser settings.
-
Chromium renders the design
The API loads the markup, styles, fonts, and assets in a managed browser environment.
-
Use the .jpeg URL
Embed the hosted result, download the file, or save it in your own storage and application records.
Output formats
One API, the format your workflow needs
Keep the same HTML and CSS. Choose lossless detail, compact compatibility, modern web delivery, or a paginated document.
Looking to capture a webpage as JPEG? Explore URL to JPEG in RubyLossless + transparent
Modern + efficient
Document + printable
.png
HTML to PNG
Crisp text, sharp UI details, and transparent backgrounds for designed graphics.
Explore PNG.webp
HTML to WebP
Strong visual quality, transparency, and modern compression for web delivery.
Explore WebP.pdf
HTML to PDF
Paginated documents with page sizing, margins, backgrounds, and print styles.
Explore PDFExample code
Render HTML to JPEG in Ruby
Copy a complete Ruby request. Authentication, HTML, CSS, viewport settings, and response handling are shown together.
Loading code example
Loading code example
Loading code example
Loading code example
Loading code example
Loading code example
Loading code example
require "json"
require "net/http"
require "uri"
request = {
html: <<~'HCTI_HTML',
<div class="card">
<h1>Hello, world!</h1>
<p>Generated from HTML and CSS.</p>
</div>
HCTI_HTML
css: <<~'HCTI_CSS',
.card {
width: 480px;
padding: 40px;
background: #f0fdf4;
color: #052e16;
font-family: sans-serif;
}
HCTI_CSS
format: "jpeg",
}
uri = URI("https://hcti.io/v1/image")
http_request = Net::HTTP::Post.new(uri)
http_request.basic_auth(ENV.fetch("HCTI_API_ID"), ENV.fetch("HCTI_API_KEY"))
http_request["Content-Type"] = "application/json"
http_request.body = JSON.generate(request)
response = Net::HTTP.start(
uri.hostname,
uri.port,
use_ssl: true,
open_timeout: 10,
read_timeout: 30
) { |http| http.request(http_request) }
unless response.is_a?(Net::HTTPSuccess)
raise format("HCTI request failed (%s): %s", response.code, response.body)
end
result = JSON.parse(response.body)
puts result.fetch("url")
Loading code example
Loading code example
Ready to render?
Create your first JPEG from HTML and CSS
Send HTML and CSS to the API and receive a hosted .jpeg image URL without running browser infrastructure.