Unir PDF sense aplanar-ho tot a imatges
La unió estructural concatena fluxos de pàgina i conserva fonts, vectors i marcadors. Rasteritzar cada pàgina és una altra feina, amb més pèrdua.
«Combina aquests cinc PDF» pot voler dir dues canalitzacions diferents. Una concatena els objectes de pàgina existents en un sol fitxer. L'altra imprimeix cada pàgina en un mapa de bits i empaqueta les imatges en un PDF nou. Totes dues produeixen un sol fitxer adjunt. Només la primera conserva text seleccionable i vectors nítids.
Què fa una unió estructural
A PDF123, Uneix combina dos PDF o més unint els objectes de pàgina de cada fitxer. El camí del servidor executa qpdf amb una base buida i --pages sobre les entrades: els fluxos de pàgina es mouen com a pàgines, no com a captures de pantalla. Les fonts incrustades, els vectors i els marcadors existents viatgen amb aquestes pàgines. Res d'aquest camí no rasteritza cap pàgina en una imatge, de manera que un contracte natiu digital encara es pot cercar i copiar després de la unió.
L'ordre de càrrega és l'ordre de sortida per defecte. El formulari HTTP accepta diverses parts fileInput en una sola petició; la mida del lot la limiten els límits de càrrega, no un màxim estricte de dos fitxers. El paràmetre opcional sortType=byFileName reordena les entrades pel nom del fitxer abans de la unió. Els marcadors de cada font poden sobreviure; una unió no inventa un arbre de contorn perfecte si les entrades no en tenien cap.
Carregar un sol fitxer és una passada sense efecte d'aquell PDF. Dos fitxers o més es converteixen en un merged.pdf les pàgines del qual són la concatenació de les entrades en l'ordre triat. El mateix identificador d'operació és el que exposen l'OpenAPI, MCP i pdfx merge, de manera que un script i un clic al navegador no discrepen en secret sobre què vol dir «unir».
Quan la gent rasteritza sense voler
Alguns fluxos de «combinar» exporten primer a imatges (passarel·les de fax, aplicacions d'escaneig, print-to-PDF a resolució de pantalla) o aplanen les anotacions en mapes de bits abans d'unir. La mida del fitxer es dispara, pot caldre tornar a fer OCR i el zoom mostra vores de píxels.
Preferiu una unió de fluxos quan les fonts ja són PDF digitals. Preferiu OCR només quan les entrades són escanejos sense text utilitzable, i recordeu que aquí l'OCR retorna Markdown (text/markdown), no un PDF amb una capa de text oculta. Rasteritzar i després fer OCR és un camí de producte diferent d'unir fitxers natius digitals.
Si el que necessiteu són imatges de les pàgines, això és una tasca de conversió (PDF a imatges), no una unió. Barrejar aquestes intencions és com els fitxers «units» es converteixen en àlbums de fotos de diversos megabytes. Comprimir després d'una unió estructural encara pot reduir els fluxos (Comprimeix); no desfà una rasterització que ja hàgiu cuit dins del fitxer.
Què no promet una unió
Una unió no normalitza les mides de pàgina, no unifica les fonts entre fitxers ni reconstrueix un índex des de zero. No desxifra les entrades xifrades per vosaltres; desbloquegeu-les primer si la font té contrasenya. No substitueix un format de contenidor de portafolis o paquet que alguns portals judicials esperen; produeix un PDF multipàgina ordinari.
Aquests límits són els mateixos tant si feu servir el navegador, REST, MCP o pdfx. L'operació és deliberadament estreta perquè la sortida continuï sent previsible per a l'automatització. Si necessiteu feina ordenada de diversos passos (unir, després marcar amb aigua i després comprimir), feu servir POST /api/v1/pipeline amb una llista ordenada de steps en lloc d'inventar un segon indicador de «unió intel·ligent».
Com executar-la
Uneix PDF al navegador, o POST /api/v1/general/merge-pdfs amb parts fileInput repetides (Desenvolupadors). Des d'un terminal:
pdfx merge a.pdf b.pdf -o merged.pdf
O contra una base allotjada o autoallotjada:
pdfx --cloud --api-base "$API_BASE" --api-key "$KEY" merge a.pdf b.pdf -o merged.pdf
Les crides anònimes del catàleg no necessiten cap clau al lloc públic; les claus són importants per a una identitat d'automatització estable i per als servidors autoallotjats restringits. Per a la mateixa operació també amb curl i MCP, vegeu La mateixa operació, quatre clients.