Base URL
All public API endpoints are under:https://api.handtextai.com/api/v1
What you can do
- Generate PNG (transparent background) for easy overlay and digital use
- Generate PDF (white background) for print workflows (crop/bleed/trim boxes, PDF/X-1a option)
- Preview your settings with a watermarked 1200px-wide PNG
- Fetch the font catalog via numeric
font_idvalues (1–90) - Run Batch Generation (CSV + templates) via the dashboard (Batch Generation)
Key concepts (important)
- Authentication: send your API key as a Bearer token (
Authorization: Bearer htext_...). - Single-page output: the renderer produces a single page. If your text overflows the available content height, remaining lines are not rendered.
- DPI scaling rule: all pixel parameters (margins, font sizes, spacing) are specified at a 300 DPI baseline and automatically scaled when you set
dpi: 600.