> ## Documentation Index
> Fetch the complete documentation index at: https://docs.handtextai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Preview (Watermarked)

> Generate a watermarked preview to test settings before final generation.

Use `POST /api/v1/preview`.

## What preview does

* Always returns a **PNG** response as JSON (`image_base64`)
* Applies a **watermark**
* Scales output to **1200px width** while keeping aspect ratio

## Notes

* `output_format` must be `"png"` (use `/generate` for PDFs).
* Preview is ideal for tuning margins, font sizing, and page selection before generating final output.
* If you enable random effects (rotation/variation/indentation) or try less-tested fonts, run preview multiple times to confirm the layout remains within your safe area.