Combinar PDFs sin aplanar todo en imágenes
Un merge correcto concatena los streams de página: fuentes, vectores y marcadores se mantienen. Rasterizar cada página a imágenes es otra tarea, con más pérdida.
«Combina estos cinco PDF» puede referirse a dos procesos distintos. Uno concatena los objetos de página existentes en un solo archivo; el otro imprime cada página como mapa de bits y empaqueta las imágenes en un PDF nuevo. Los dos producen un único adjunto, pero solo el primero conserva texto seleccionable y vectores nítidos.
Qué hace una combinación estructural
En PDF123, Combinar une dos o más PDF juntando los objetos de página de cada archivo. La ruta del servidor ejecuta qpdf con una base vacía y --pages sobre las entradas: los streams de página se mueven como páginas, no como capturas de pantalla. Las fuentes incrustadas, los vectores y los marcadores existentes viajan con esas páginas. Nada en esa ruta rasteriza una página a imagen, así que un contrato nativo digital sigue permitiendo buscar y copiar tras la unión.
El orden de subida es el orden de salida de forma predeterminada. El formulario HTTP acepta partes fileInput repetidas en una misma petición; el tamaño del lote lo marcan los límites de subida, no un tope fijo de dos archivos. El opcional sortType=byFileName reordena las entradas por nombre de archivo antes de unirlas. Los marcadores de cada fuente pueden sobrevivir; la combinación no inventa un árbol de índice perfecto si las entradas nunca lo tuvieron.
Subir un solo archivo es una operación nula que devuelve ese PDF. Dos o más archivos se convierten en un merged.pdf cuyas páginas son la concatenación de las entradas en el orden elegido. El mismo id de op es el que exponen OpenAPI, MCP y pdfx merge, de modo que un script y un clic en el navegador no discrepan en silencio sobre qué es «combinar».
Cuando se rasteriza sin querer
Algunos flujos de «combinar» exportan primero a imágenes (pasarelas de fax, aplicaciones de escaneo, imprimir a PDF a resolución de pantalla) o aplanan las anotaciones a mapas de bits antes de unir. El tamaño del archivo se dispara, puede hacer falta OCR otra vez y al ampliar se ven bordes de píxel.
Prefiere una combinación de streams cuando los archivos de origen ya sean PDF digitales. Recurre a OCR solo cuando las entradas sean escaneos sin texto utilizable, y recuerda que el OCR de este sitio devuelve Markdown (text/markdown), no un PDF con una capa de texto oculta reconstruida. Rasterizar y luego aplicar OCR es una ruta de producto distinta de combinar archivos digitales nativos.
Si lo que necesitas son imágenes de las páginas, eso es una tarea de conversión (PDF a imágenes), no una combinación. Mezclar esas intenciones es lo que convierte los archivos «combinados» en álbumes fotográficos de varios megabytes. Comprimir después de una combinación estructural todavía puede reducir los streams (Comprimir), pero no deshace un aplanado raster ya aplicado.
Qué no promete la combinación
La combinación no normaliza tamaños de página, no unifica fuentes entre archivos ni reconstruye un índice desde cero. Tampoco descifra las entradas cifradas: desbloquea primero si el origen está protegido con contraseña. No sustituye al formato contenedor de portafolio que esperan algunos portales judiciales; produce un PDF normal de varias páginas.
Esos límites son los mismos uses el navegador, REST, MCP o pdfx. La op es deliberadamente estrecha para que la salida siga siendo predecible en automatización. Si necesitas trabajo ordenado de varios pasos (combinar, luego marcar con agua, luego comprimir), usa POST /api/v1/pipeline con una lista ordenada steps en lugar de inventar un segundo flag de «combinación inteligente».
Cómo ejecutarlo
Combinar PDFs en el navegador, o POST /api/v1/general/merge-pdfs con partes fileInput repetidas (Desarrolladores). Desde un shell:
pdfx merge a.pdf b.pdf -o merged.pdf
O fija una base y una clave explícitas, para un servidor autoalojado o alternativo:
pdfx --api-base "$API_BASE" --api-key "$KEY" merge a.pdf b.pdf -o merged.pdf
Las llamadas anónimas al catálogo no necesitan clave en el sitio público; las claves importan para una identidad de automatización estable y para servidores autoalojados restringidos. Para ver la misma op también con curl y MCP, consulta La misma operación, cuatro clientes.