Mesclar PDFs sem achatar tudo em imagens

"Mescle estes cinco PDFs" pode significar dois fluxos bem diferentes. Um deles concatena os objetos de página que já existem num único arquivo. O outro imprime cada página como bitmap e empacota as imagens num PDF novo. Os dois entregam um anexo só. Apenas o primeiro preserva texto selecionável e vetores nítidos.

O que uma mesclagem estrutural faz

No PDF123, Mesclar combina dois ou mais PDFs unindo os objetos de página de cada arquivo. O caminho do servidor roda o qpdf com uma base vazia e --pages sobre as entradas: os fluxos de página se movem como páginas, não como capturas de tela. Fontes embutidas, vetores e marcadores já existentes viajam junto com essas páginas. Nada nesse caminho rasteriza uma página em imagem, então um contrato nativo digital continua pesquisável e copiável depois da junção.

A ordem de upload é a ordem da saída por padrão. O formulário HTTP aceita partes fileInput repetidas numa mesma requisição; o tamanho do lote é limitado pelos limites de upload, não por um teto rígido de dois arquivos. A opção sortType=byFileName reordena as entradas por nome de arquivo antes da junção. Os marcadores de cada origem podem sobreviver; uma mesclagem não inventa uma árvore de tópicos perfeita se as entradas nunca tiveram uma.

O upload de um único arquivo é apenas um repasse sem alteração daquele PDF. Dois ou mais arquivos viram um merged.pdf cujas páginas são a concatenação das entradas na ordem escolhida. É o mesmo id de operação que a OpenAPI, o MCP e o pdfx merge expõem, então um script e um clique no navegador não divergem em silêncio sobre o que é "mesclar".

Quando as pessoas rasterizam sem perceber

Alguns fluxos de "combinar" exportam para imagem antes de juntar (gateways de fax, aplicativos de digitalização, print-to-PDF em resolução de tela) ou achatam anotações em bitmaps. O arquivo cresce, o OCR pode ser necessário outra vez e o zoom passa a mostrar bordas de pixel.

Prefira uma mesclagem de fluxos quando as origens já são PDFs digitais. Prefira o OCR apenas quando as entradas forem digitalizações sem texto aproveitável, e lembre que o OCR aqui devolve Markdown (text/markdown), não um PDF com camada de texto oculta refeita. Rasterizar e depois aplicar OCR é um caminho de produto diferente de mesclar arquivos nativos digitais.

Se o que você precisa são imagens das páginas, isso é uma tarefa de conversão (PDF para imagens), não uma mesclagem. Misturar essas intenções é o que transforma arquivos "mesclados" em álbuns de fotos de vários megabytes com aparência de documento. Comprimir depois de uma mesclagem estrutural ainda pode encolher os fluxos (Comprimir), mas não desfaz um achatamento em raster que você já gravou.

O que a mesclagem não promete

A mesclagem não normaliza tamanhos de página, não unifica fontes entre arquivos nem reconstrói um sumário do zero. Ela não descriptografa entradas protegidas: desbloqueie antes se a origem tiver senha. E não substitui um formato de portfólio ou pacote que alguns portais de tribunais exigem; ela produz um PDF comum, de várias páginas.

Esses limites são os mesmos no navegador, no REST, no MCP ou no pdfx. A operação é estreita de propósito, para que a saída continue previsível em automação. Se você precisa de trabalho ordenado em várias etapas (mesclar, depois marcar com watermark, depois comprimir), use POST /api/v1/pipeline com uma lista ordenada em steps, em vez de inventar uma segunda opção de "smart merge".

Como executar

Mesclar PDFs no navegador, ou POST /api/v1/general/merge-pdfs com partes fileInput repetidas (Desenvolvedores). No shell:

pdfx merge a.pdf b.pdf -o merged.pdf

Ou contra uma URL base hospedada ou self-hosted:

pdfx --cloud --api-base "$API_BASE" --api-key "$KEY" merge a.pdf b.pdf -o merged.pdf

Chamadas anônimas do catálogo não precisam de chave no site público; as chaves importam para dar identidade estável à automação e para servidores self-hosted com controle de acesso. Para a mesma operação via curl e MCP também, veja A mesma operação em quatro clientes.