No browser runtime to maintain
Keep Rails applications and background jobs free of separate browser processes and browser-specific deployment dependencies.
HTML to WebP with Ruby
Generate WebP images with Ruby
No browser management required
Render HTML and CSS from Ruby with the htmlcsstoimage-api Gem 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 .webp 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 .webp URL.
-
HTML and CSS input
Send complete markup and styles, including browser-supported fonts, images, SVG, and JavaScript.
-
WebP output
Set format to webp and use the hosted .webp 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 WebP
-
Send HTML and CSS
Submit the content with format set to webp 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 .webp 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 WebP? Explore URL to WebP in Ruby with the HCTI GemLossless + transparent
Compact + universal
Document + printable
.png
HTML to PNG
Crisp text, sharp UI details, and transparent backgrounds for designed graphics.
Explore PNG.jpeg
HTML to JPEG
Smaller files and broad compatibility for photography, previews, and content-heavy pages.
Explore JPEG.pdf
HTML to PDF
Paginated documents with page sizing, margins, backgrounds, and print styles.
Explore PDFExample code
Render HTML to WebP 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
# gem install htmlcsstoimage-api
require "htmlcsstoimage"
# Uses HCTI_USER_ID and HCTI_API_KEY from the environment.
client = HTMLCSSToImage.new
result = client.create_image(
<<~'HCTI_CONTENT',
<div class="card">
<h1>Hello, world!</h1>
<p>Generated from HTML and CSS.</p>
</div>
HCTI_CONTENT
css: <<~'HCTI_CSS',
.card {
width: 480px;
padding: 40px;
background: #f0fdf4;
color: #052e16;
font-family: sans-serif;
}
HCTI_CSS
)
puts result.url
Loading code example
Loading code example
Loading code example
Ready to render?
Create your first WebP from HTML and CSS
Send HTML and CSS to the API and receive a hosted .webp image URL without running browser infrastructure.