Afbeelding naar PDF

Combineer een of meer afbeeldingen tot een PDF-document. Ondersteunt meerdere paginagroottes, oriëntaties, marges en optionele doelbestandsgrootte via kwaliteitsaanpassing.

API Endpoint

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

Accepteert multipart-formuliergegevens met een of meer afbeeldingsbestanden en een JSON-veld settings.

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
pageSize	string	Nee	"A4"	Paginagrootte: A4, Letter, A3, A5
orientation	string	Nee	"portrait"	Pagina-oriëntatie: portrait of landscape
margin	number	Nee	20	Paginamarge in punten (0-500)
targetSize	object	Nee	-	Beperking van de doelbestandsgrootte (zie hieronder)
collate	boolean	Nee	true	Combineer alle afbeeldingen tot één PDF. Indien false, maak één PDF per afbeelding.

Target Size-object

Veld	Type	Vereist	Beschrijving
value	number	Ja	Waarde van de doelgrootte
unit	string	Ja	Eenheid: KB of MB

De minimale doelgrootte is 50 KB.

Voorbeeldverzoek

Basis-PDF met meerdere afbeeldingen:

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}'

Met doelbestandsgrootte:

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"}}'

Eén PDF per afbeelding:

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}'

Voorbeeldantwoord (gecollationeerd)

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

Voorbeeldantwoord (niet-gecollationeerd)

{
  "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
}

Voorbeeldantwoord (met doelgrootte)

{
  "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
  }
}

Opmerkingen

• Afbeeldingen worden op de pagina gecentreerd en geschaald om binnen de marges te passen met behoud van de beeldverhouding. Afbeeldingen worden nooit vergroot.
• Wanneer collate false is, wordt elke afbeelding een afzonderlijk PDF-bestand, en de download is een ZIP-archief met alle PDF's.
• De functie voor doelgrootte gebruikt iteratief binair zoeken over JPEG-kwaliteitsniveaus (10-95) om de beste kwaliteit te vinden die binnen het budget past.
• Transparante afbeeldingen worden samengevoegd op wit voordat ze in de PDF worden ingebed.
• Ondersteunde invoerformaten: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW, PSD, SVG en meer.
• EXIF-oriëntatie wordt automatisch toegepast vóór het inbedden.