Stolid PDF · HTML to PDF API

HTML to PDF, with warnings your code can use.

Generate invoices, statements and reports from the HTML you already have. Stolid PDF returns the PDF and stable warning codes for detected font, asset and layout issues, so your app or your AI agent can decide what to fix or review.

Free public preview · 500 live + 100 test calls a month · no card · keys by email

Try one template with sample data. Attach the CSS, images and fonts it needs. Up to 20 pages, 30 seconds and a 6 MB request per render. See the limits

01 / Render report

Render reports with stable warning codes.

A PDF can render successfully and still use a substitute font or cut off a wide table. Every successful render includes a report that lists the issues Stolid detected, each with a stable code and a message. Use them to fix the template, log a warning or ask for a review.

Illustration · sample invoice · sample data

manifest.warnings3 items
The three warnings in the example render report
#CodeWhat it means
FONT_FALLBACKA font you asked for is not available; a similar one was used.
REQUEST_BLOCKEDA file request was blocked. Send remote files in assets.
CONTENT_OVERFLOWContent extends past the page width or a clipping container.
The same report, as your code receives itJSON
"warnings": [
  { "code": "FONT_FALLBACK",    "message": "…" },
  { "code": "REQUEST_BLOCKED",  "message": "…" },
  { "code": "CONTENT_OVERFLOW", "message": "…" }
]

The report lists the issues Stolid detects, such as missing fonts, blocked requests and overflowing content. An empty list means no warnings were reported; it does not guarantee that the layout is correct, so check the PDF as well. See every warning code

02 / AI agents

Give your agent useful feedback after every render.

An agent can call the HTTP API today, read the warning codes and revise its HTML to fix the issues they describe. Your application sets the fixes, the retry limit and the final check. PDF generation for AI agents

1 -> Render

The agent sends its HTML and files to the Stolid PDF API.

2 -> Read codes

It reads the warning codes in manifest.warnings.

3 -> Fix

It edits the HTML or attaches the missing file.

4 -> Retry and check

It renders again, within a limit you choose. Then your workflow checks the PDF.

Docs

Readable by agents

llms.txt, a Markdown version of every page, and the OpenAPI description.

Counting

Failed renders do not count

A render counts when it succeeds, including a render with warnings. Each revised document that renders successfully uses one call.

Retries

Safe retries

Repeat a request with the same Idempotency-Key within 24 hours and you get the original render, counted once. Use a new key when the document changes.

Testing

A separate test allowance

100 test calls a month in the preview, counted apart from your 500 live calls.

03 / Clients

Python and Node clients. Or plain HTTP.

Keep your HTML templates and send the files they need. Stolid runs the Chromium renderer; your application calls it over HTTP or through the typed Python and Node clients. The client package files come with your preview key email; publication on PyPI and npm is Coming soon. If you run Puppeteer, wkhtmltopdf or WeasyPrint yourself today, Stolid PDF is a hosted option for the HTML-to-PDF part. Client guide

Pythonstolid-client · PyPI coming soon
from stolid_client import StolidClient

client = StolidClient()  # reads STOLID_API_KEY
html = "<h1>Invoice 0042</h1>"
render = client.create_pdf(html)

for warning in render.warnings:
    print(warning.code, warning.message)
Node@stolidhq/client · npm coming soon
import { StolidClient, getWarnings } from '@stolidhq/client';

const client = new StolidClient(); // reads STOLID_API_KEY
const html = '<h1>Invoice 0042</h1>';
const render = await client.createPdf(html);

for (const w of getWarnings(render)) console.warn(w.code, w.message);

04 / Pricing after the preview

One unit: the call.

The public preview is free: 500 live and 100 test calls a month, no card. The prices below are planned and may change before paid plans launch. See pricing

Free · planned

$0

Planned free tier: 100 calls a month. No card.

Pay as you go · planned

$0.01

Per call. Prepaid, from $5.

Build · planned

$19

A month. 3,000 calls.

Scale · planned

$79

A month. 20,000 calls.

Business · planned

$249

A month. 100,000 calls.

Enterprise · planned

Custom

AWS Marketplace private offers.

1 call = one document, up to 20 pages and 30 secondsFailed renders do not countRenders with warnings countTest calls are counted separately

05 / Data handling

Know where your documents go.

  • Documents sent to the API are rendered and stored on AWS in US East (N. Virginia), us-east-1.
  • A render stays available through the API for 24 hours, and each download link works for one hour.
  • During the public preview, use sample data. Keep real customer details, personal data and secrets out of requests.
  • Read the data handling page

06 / Coming soon

On the way for agent builders.

These are in development and are not available yet. Today, agents use the HTTP API.

MCP Coming soon

Hosted MCP server

A remote MCP server with a Stolid PDF tool. It will use the same keys as the HTTP API.

Vision Coming soon

Optional page images

Images of the rendered pages, so an agent can look at the result next to the report.

Limits Coming soon

Spending caps per key

A cap, in calls, on each key you hand to a script or an agent.

Safety Coming soon

Untrusted-content labels

Labels that help an agent tell document text apart from instructions.