← All microservices
PDF to image
PDF
Render PDF pages as PNG, JPG or WebP images at the resolution you choose. Good for thumbnails and previews.
What it does
- PNG, JPG or WebP
- Choose the DPI, or an exact width in pixels
- One page as an image, several as a zip
- Oversized pages scaled down safely
Good for
- Document previews
- Thumbnails in file lists
- Sharing a page as an image
For thumbnails, set a width such as 240 pixels and every page comes back exactly that wide.
Example
POST https://bloodweb.net/api/v1/pdf-to-image
curl -H "Authorization: Bearer YOUR_KEY" -F file=@report.pdf -F pages=1 -F dpi=72 https://bloodweb.net/api/v1/pdf-to-image -o cover.png
Options
| Name | Description |
|---|---|
filefile |
The PDF, up to 50MB. |
pages
|
Pages to render, such as 1-3,5 or all. Default: 1 |
dpi
|
Resolution. 72 for thumbnails, 150 for screens, 300 for print. Default: 150 |
width
|
Render each page this many pixels wide instead of by DPI, keeping proportions. Handy for thumbnails. |
to
|
Image format. One of: png, jpg, webp Default: png |
quality
|
For JPG and WebP. Default: 85 |
Returns
One page: the image. Several pages: a zip of page-1.png, page-2.png and so on.
Limits
50 pages per call. Very large pages render at a lower DPI so no side passes 10,000 pixels.