Bild till PDF

Kombinera en eller flera bilder till ett PDF-dokument. Stöder flera sidstorlekar, orienteringar, marginaler och valfri målfilstorlek via kvalitetsjustering.

API-slutpunkt

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

Tar emot multipart-formulärdata med en eller flera bildfiler och ett JSON-fält settings.

Parametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
pageSize	string	Nej	"A4"	Sidstorlek: A4, Letter, A3, A5
orientation	string	Nej	"portrait"	Sidorientering: portrait eller landscape
margin	number	Nej	20	Sidmarginal i punkter (0-500)
targetSize	object	Nej	-	Begränsning för målfilstorlek (se nedan)
collate	boolean	Nej	true	Kombinera alla bilder till en PDF. Om false skapas en PDF per bild.

Målstorleksobjekt

Fält	Typ	Obligatorisk	Beskrivning
value	number	Ja	Målstorleksvärde
unit	string	Ja	Enhet: KB eller MB

Minsta målstorlek är 50 KB.

Exempelbegäran

Grundläggande PDF med flera bilder:

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

Med målfilstorlek:

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

En PDF per 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}'

Exempelsvar (sammanfogat)

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

Exempelsvar (ej sammanfogat)

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

Exempelsvar (med målstorlek)

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

Anmärkningar

• Bilder centreras på sidan och skalas för att passa inom marginalerna med bibehållet bildförhållande. Bilder förstoras aldrig.
• När collate är false blir varje bild en separat PDF-fil, och nedladdningen är ett ZIP-arkiv som innehåller alla PDF-filer.
• Funktionen för målstorlek använder iterativ binärsökning över JPEG-kvalitetsnivåer (10-95) för att hitta den bästa kvaliteten som ryms inom budgeten.
• Transparenta bilder plattas ut till vitt innan de bäddas in i PDF-filen.
• Format som stöds för inmatning: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW, PSD, SVG med flera.
• EXIF-orientering tillämpas automatiskt före inbäddning.