Imagem para PDF

Combine uma ou mais imagens em um documento PDF. Suporta vários tamanhos de página, orientações, margens e definição opcional de tamanho de arquivo alvo por ajuste de qualidade.

Endpoint da API

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

Aceita dados de formulário multipart com um ou mais arquivos de imagem e um campo JSON settings.

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
pageSize	string	Não	"A4"	Tamanho da página: A4, Letter, A3, A5
orientation	string	Não	"portrait"	Orientação da página: portrait ou landscape
margin	number	Não	20	Margem da página em pontos (0-500)
targetSize	object	Não	-	Restrição de tamanho de arquivo alvo (veja abaixo)
collate	boolean	Não	true	Combina todas as imagens em um único PDF. Se false, cria um PDF por imagem.

Objeto de Tamanho Alvo

Campo	Tipo	Obrigatório	Descrição
value	number	Sim	Valor do tamanho alvo
unit	string	Sim	Unidade: KB ou MB

O tamanho alvo mínimo é 50 KB.

Exemplo de Requisição

PDF básico com várias imagens:

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

Com tamanho de arquivo alvo:

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

Um PDF por imagem:

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

Exemplo de Resposta (Combinada)

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

Exemplo de Resposta (Não Combinada)

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

Exemplo de Resposta (Com Tamanho Alvo)

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

Observações

• As imagens são centralizadas na página e escaladas para caber dentro das margens preservando a proporção. As imagens nunca são ampliadas.
• Quando collate é false, cada imagem se torna um arquivo PDF separado, e o download é um arquivo ZIP contendo todos os PDFs.
• O recurso de tamanho alvo usa busca binária iterativa sobre os níveis de qualidade JPEG (10-95) para encontrar a melhor qualidade que caiba dentro do orçamento.
• Imagens transparentes são achatadas para branco antes de serem incorporadas ao PDF.
• Formatos de entrada suportados: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC, RAW, PSD, SVG e outros.
• A orientação EXIF é aplicada automaticamente antes da incorporação.