Docs
Readable by agents
llms.txt, a Markdown version of every page, and the OpenAPI description.
Stolid PDF · HTML to PDF API
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
curl https://api.stolid.dev/v1/pdf \ -H "Authorization: Bearer stolid_live_…" \ -H "Content-Type: application/json" \ -d '{"html": "<h1>Invoice 0042</h1> …"}'
{
"id": "rnd_…",
"status": "succeeded",
"pdf_url": "https://…",
"manifest": {
"warnings": [
{
"code": "CONTENT_OVERFLOW",
"message": "<table> extends 118px past the printable width and will be cut off."
}
]
}
}
01 / Render report
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
| # | Code | What it means |
|---|---|---|
| FONT_FALLBACK | A font you asked for is not available; a similar one was used. | |
| REQUEST_BLOCKED | A file request was blocked. Send remote files in assets. | |
| CONTENT_OVERFLOW | Content extends past the page width or a clipping container. |
"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
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
llms.txt, a Markdown version of every page, and the OpenAPI description.
Counting
A render counts when it succeeds, including a render with warnings. Each revised document that renders successfully uses one call.
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
100 test calls a month in the preview, counted apart from your 500 live calls.
03 / Clients
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
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)
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
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.
05 / Data handling
06 / Coming soon
These are in development and are not available yet. Today, agents use the HTTP API.
MCP Coming soon
A remote MCP server with a Stolid PDF tool. It will use the same keys as the HTTP API.
Vision Coming soon
Images of the rendered pages, so an agent can look at the result next to the report.
Limits Coming soon
A cap, in calls, on each key you hand to a script or an agent.
Safety Coming soon
Labels that help an agent tell document text apart from instructions.
Free public preview · access by request
Tell us what you would render and which language you use. We reply by email with the preview terms to accept, then your preview keys and the client package files. Bring one template and some sample data.