Bild zu PDF

Kombiniert ein oder mehrere Bilder zu einem PDF-Dokument. Unterstützt mehrere Seitengrößen, Ausrichtungen, Ränder und optionale Zieldateigröße über die Qualitätsanpassung.

API-Endpunkt

POST /api/v1/tools/image/image-to-pdf

Akzeptiert Multipart-Formulardaten mit einer oder mehreren Bilddateien und einem JSON-Feld settings.

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
pageSize	string	Nein	"A4"	Seitengröße: A4, Letter, A3, A5
orientation	string	Nein	"portrait"	Seitenausrichtung: portrait oder landscape
margin	number	Nein	20	Seitenrand in Punkten (0-500)
targetSize	object	Nein	-	Beschränkung der Zieldateigröße (siehe unten)
collate	boolean	Nein	true	Alle Bilder in einem PDF kombinieren. Falls false, wird pro Bild ein PDF erstellt.

Objekt „Zielgröße“

Feld	Typ	Erforderlich	Beschreibung
value	number	Ja	Wert der Zielgröße
unit	string	Ja	Einheit: KB oder MB

Die minimale Zielgröße beträgt 50 KB.

Beispielanfrage

Einfaches PDF aus mehreren Bildern:

curl -X POST http://localhost:1349/api/v1/tools/image/image-to-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"pageSize": "A4", "orientation": "portrait", "margin": 20}'

Mit Zieldateigröße:

curl -X POST http://localhost:1349/api/v1/tools/image/image-to-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"pageSize": "Letter", "targetSize": {"value": 2, "unit": "MB"}}'

Ein PDF pro Bild:

curl -X POST http://localhost:1349/api/v1/tools/image/image-to-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"collate": false}'

Beispielantwort (zusammengeführt)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/images.pdf",
  "originalSize": 5000000,
  "processedSize": 1200000,
  "pages": 3
}

Beispielantwort (nicht zusammengeführt)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/images.zip",
  "originalSize": 5000000,
  "processedSize": 2400000,
  "pages": 2,
  "collated": false
}

Beispielantwort (mit Zielgröße)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/images.pdf",
  "originalSize": 10000000,
  "processedSize": 2000000,
  "pages": 5,
  "compression": {
    "targetRequested": 2097152,
    "targetMet": true,
    "jpegQuality": 72
  }
}

Hinweise

• Bilder werden auf der Seite zentriert und so skaliert, dass sie unter Beibehaltung des Seitenverhältnisses innerhalb der Ränder passen. Bilder werden niemals hochskaliert.
• Wenn collate auf false steht, wird jedes Bild zu einer separaten PDF-Datei, und der Download ist ein ZIP-Archiv, das alle PDFs enthält.
• Die Funktion für die Zielgröße verwendet eine iterative binäre Suche über die JPEG-Qualitätsstufen (10-95), um die beste Qualität zu finden, die in das Budget passt.
• Transparente Bilder werden vor dem Einbetten in das PDF auf Weiß abgeflacht.
• Unterstützte Eingabeformate: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW, PSD, SVG und mehr.
• Die EXIF-Ausrichtung wird vor dem Einbetten automatisch angewendet.