Images to PDF
Put 1 to 50 pictures into one PDF, one picture on each page. Pages fit the picture, or use A4 or Letter with a margin.
Input
Result
Choose a file and press Run.
Files you upload and the results are stored for one hour, then deleted. Anyone who has the link can open them, so don't upload anything private.
Use it from code or an agent
# 1. Upload each file. The reply ends with a line "ref <id>/f1": that is the file reference.
curl -T sample.jpg https://setget.net/drop/
curl -T sample.png https://setget.net/drop/
# 2. Run the tool with those references. "wait" holds the reply for up to 30 seconds while the job runs.
curl -s https://setget.net/v1/tools/images-to-pdf \
-H 'Content-Type: application/json' \
-d '{"input":{"files":["DROP_1/f1","DROP_2/f1"]},"wait":30}'
# 3. The reply is {"tool", "ms", "result", "files": [{"name", "size", "url", "ref"}], "job"}.
# Download a result file from its "url", or pass its "ref" to another tool.
# Still running after the wait? The reply is 202 with "job": follow it with
# curl -s https://setget.net/v1/jobs/JOB_ID?wait=30
import json, urllib.parse, urllib.request
BASE = "https://setget.net"
def call(method, path, body=None, headers=None):
request = urllib.request.Request(BASE + path, body, headers or {}, method=method)
return json.load(urllib.request.urlopen(request))
def upload(path):
"""Step 1: upload a file and get its reference."""
name = path.replace("\\", "/").rsplit("/", 1)[-1]
with open(path, "rb") as handle:
reply = call("PUT", "/drop/" + urllib.parse.quote(name), handle.read(), {"Accept": "application/json"})
return reply["file"]["ref"]
# Step 2: run the tool with the reference.
body = {"input": {'files': [upload("sample.jpg"), upload("sample.png")]}, "wait": 30}
reply = call("POST", "/v1/tools/images-to-pdf", json.dumps(body).encode(), {"Content-Type": "application/json"})
# Step 3: a job that is still running comes back as {"job": ...}. Wait for it.
while "result" not in reply and reply.get("job", reply).get("status") in ("queued", "running"):
reply = call("GET", "/v1/jobs/" + reply.get("job", reply)["id"] + "?wait=30")
if "error" in reply:
raise SystemExit(reply["error"]["message"])
print(reply["result"])
for file in reply["files"]: # result files: download from "url", or pass "ref" to another tool
print(file["name"], file["size"], file["url"], file["ref"])
const BASE = "https://setget.net";
// Step 1: upload a file and get its reference. file1, file2: a File or Blob
// (in Node: new Blob([fs.readFileSync(path)])).
async function upload(file, name) {
const response = await fetch(`${BASE}/drop/${encodeURIComponent(name)}`, {
method: "PUT", headers: {Accept: "application/json"}, body: file,
});
return (await response.json()).file.ref;
}
// Step 2: run the tool with the reference.
let reply = await (await fetch(`${BASE}/v1/tools/images-to-pdf`, {
method: "POST",
headers: {"Content-Type": "application/json"},
body: JSON.stringify({input: {"files":[await upload(file1, "sample.jpg"),await upload(file2, "sample.png")]}, wait: 30}),
})).json();
// Step 3: a job that is still running comes back as {job}. Wait for it.
while (!reply.result && ["queued", "running"].includes((reply.job || reply).status)) {
reply = await (await fetch(`${BASE}/v1/jobs/${(reply.job || reply).id}?wait=30`)).json();
}
if (reply.error) throw new Error(reply.error.message);
console.log(reply.result);
for (const file of reply.files) console.log(file.name, file.size, file.url, file.ref);
1. Upload. Tool: drop
Arguments:
{
"action": "create",
"files": [
{
"name": "sample.jpg",
"size": "<bytes>"
},
{
"name": "sample.png",
"size": "<bytes>"
}
]
}
PUT each file's bytes to its "upload.url" with the listed headers, and keep its "ref".
With a shell, one command does both: curl -T FILE https://setget.net/drop/
2. Run. Tool: run_tool
Arguments:
{
"slug": "images-to-pdf",
"input": {
"files": [
"DROP_1/f1",
"DROP_2/f1"
]
}
}
3. The answer holds "result" and "files" (each with "url" and "ref").
If it holds a "job" that is still running instead, follow it. Tool: job
Arguments:
{
"action": "wait",
"id": "JOB_ID"
}
{
"input": {
"files": [
"DROP_1/f1",
"DROP_2/f1"
]
},
"wait": 30
}
This is a file tool, so a call takes three steps: upload the file to get a reference, run the tool with that reference, then read the result and download its files. Uploads and results are public by link and expire after one hour.
Endpoint: POST /v1/tools/images-to-pdf. Over MCP: run_tool with slug: "images-to-pdf".
Machine-readable: input schema, Markdown. Connect an agent.
Inputs
| Name | Type | Required | What it does |
|---|---|---|---|
files |
files | yes | The pictures, in page order. PNG, JPG, WebP, GIF, TIFF, BMP and HEIC work. In the API: a list of file references such as DROP_ID/f1. Accepts: image. At most 50 files. |
page_size |
string | no | fit makes each page exactly as large as its picture. a4 and letter place each picture as large as it fits on that paper, centred. One of: fit, a4, letter. Default: "fit". |
orientation |
string | no | For a4 and letter: auto turns the paper to match each picture; portrait and landscape use the same direction for every page. One of: auto, portrait, landscape. Default: "auto". |
margin |
number | no | White space around each picture, in millimetres. Default: 0. From 0 to 50. |
compress |
boolean | no | Store every picture as a JPEG of good quality. This makes a much smaller PDF from scans and screenshots, with slightly softer edges. Off, pictures keep every pixel. Default: false. |
Examples
Two pictures, each on a page of its own size
{
"files": [
"sample.jpg",
"sample.png"
]
}Press the example button above to run it on the sample files.
A photo on A4 with a margin
{
"files": [
"sample.jpg"
],
"page_size": "a4",
"margin": 10
}Press the example button above to run it on the sample files.
Letter landscape, stored small
{
"files": [
"sample-transparent.png",
"sample.png"
],
"page_size": "letter",
"orientation": "landscape",
"compress": true
}Press the example button above to run it on the sample files.
Questions
- Do my pictures lose quality?
- No, unless you turn compress on. JPEG photos are put into the PDF as they are, and other pictures keep every pixel.
- My phone photo is sideways in other tools. Here too?
- No. The direction the camera recorded is applied, so photos come out upright.
- What happens to see-through areas?
- They become white, because a PDF page is white paper.
- How large is a fit page?
- As large as the picture at its own resolution, which pictures from scanners state. Where a picture states none, 96 pixels are taken as one inch.
- What are the limits?
- 50 pictures, 50 megapixels for each picture and 400 megapixels together. An animated picture gives its first frame.
Conversions this tool does
Related tools
- PDF to imagesTurn PDF pages into PNG, JPG or WebP pictures at the sharpness you choose. Up to 50 pages in one run, as files or one zip.
pdf-to-images - Merge PDFsJoin 2 to 20 PDF files into one PDF, in the order you give them. Bookmarks are kept.
pdf-merge - Compress a PDFMake a PDF file smaller by packing its contents tighter and, if you allow it, re-saving its pictures at a lower resolution.
pdf-compress - Scanned PDF to text (OCR)Read the text in a scanned PDF and get it as a text file, or as a PDF you can search and copy from.
ocr-pdf - Convert image formatConvert an image between PNG, JPG, WebP, AVIF, GIF, BMP, TIFF and ICO. Animated GIF and WebP stay animated.
image-convert - Anything to MarkdownTurn almost any document into Markdown: PDF, Word, PowerPoint, Excel, HTML, EPUB, e-mail, notebooks, CSV.
any-to-markdown