§ Build and extract
Images to PDF API
Send images in the order you want them and get a document with one image per page, on the page size you pick. Accepts PNG, JPEG, GIF, and TIFF.
- Endpoint
- POST /pdf/from-images
- Inputs
- 1 to 20 images
- Returns
- application/pdf
- Limits
- 50 M pixels per image, 100 M pixels per request. Gated on pixels, not bytes.
- Price
- $0.001
§ 01 The request
One POST, and the file comes back.
POST /pdf/from-images
curl -sS --fail-with-body \
-o receipts.pdf \
-H "Authorization: Bearer $OHMYWRAP_KEY" \
-F "file=@receipt-1.jpg" \
-F "file=@receipt-2.jpg" \
-F 'options={"pageSize":"A4","dpi":150,"position":"c"}' \
https://api.ohmywrap.com/pdf/from-imagesOptions
| Option | Type | Default | What it does |
|---|---|---|---|
| pageSize | string | A4 | A0–A8, Letter, Legal, Ledger, Tabloid, Executive, ANSIC–ANSIE. |
| dpi | int | — | Must be positive. |
| position | string | — | tl tc tr l c r bl bc br. |
| scale | float | — | Relative 0–1, or any positive value with `scaleAbsolute`. |
| scaleAbsolute | bool | false | Treat `scale` as absolute. |
| gray | bool | false | Render greyscale. |
| sepia | bool | false | Render sepia. |
| backgroundColor | string | — | #RRGGBB page background. |
Worth knowing
This endpoint is gated on pixels, not bytes: a 1.2 KB PNG can decode to hundreds of megabytes, so a tiny upload can still be 413 pixel_limit_exceeded. JPEG input is markedly faster than PNG, which has to be re-encoded.
Your first /pdf/from-images call takes one line of curl.
Ten thousand calls cost ten dollars, the pack never expires, and nothing you send is kept.
10,000 calls for $10. No subscription, no expiry.