Об’єднання PDF без сплющення всього в зображення
Справжнє об’єднання PDF зшиває потоки сторінок: шрифти, вектори й закладки лишаються цілими. Растеризація кожної сторінки в зображення — інша, втратніша робота.
«Об’єднай ці п’ять PDF» може означати два конвеєри. Один зшиває наявні об’єкти сторінок у єдиний файл. Другий друкує кожну сторінку в растрове зображення й пакує ці картинки в новий PDF. Обидва дають один вкладений файл. Лише перший зберігає текст, який можна виділити, і чіткі вектори.
Що робить структурне об’єднання
На PDF123 Об’єднання поєднує два чи більше PDF, зшиваючи об’єкти сторінок кожного файлу. Серверний шлях запускає qpdf із порожньою основою та --pages по вхідних файлах: потоки сторінок переміщуються як сторінки, а не як знімки екрана. Вбудовані шрифти, вектори й наявні закладки подорожують разом із цими сторінками. Ніщо в цьому шляху не растеризує сторінку в зображення, тож цифровий договір і після зшивання можна шукати й копіювати.
Порядок завантаження типово є порядком виводу. HTTP-форма приймає повторювані частини fileInput в одному запиті; розмір пакета обмежений лімітами завантаження, а не жорсткою межею у два файли. Необов’язковий sortType=byFileName перевпорядковує вхідні файли за назвою перед зшиванням. Закладки з кожного джерела можуть зберегтися; об’єднання не вигадує бездоганного дерева змісту, якщо його ніколи не було у вхідних файлах.
Завантаження одного файлу — це наскрізний пропуск без змін. Два чи більше файлів стають одним merged.pdf, сторінки якого є конкатенацією вхідних у вибраному порядку. Той самий ідентифікатор операції відкривають OpenAPI, MCP і pdfx merge, тож скрипт і клік у браузері не розходяться нишком у розумінні «об’єднання».
Коли люди випадково растеризують
Деякі процеси «поєднання» спершу експортують у зображення (факс-шлюзи, застосунки для сканування, друк у PDF з екранною роздільністю) або сплющують анотації в растр перед зшиванням. Розмір файлу стрибає, OCR може знадобитися знову, а масштабування показує піксельні сходинки.
Віддавайте перевагу потоковому об’єднанню, коли джерела — це вже цифрові PDF. Вдавайтеся до OCR лише тоді, коли вхідні файли є сканами без придатного тексту, і пам’ятайте, що тутешній OCR повертає Markdown (text/markdown), а не PDF із відновленим прихованим текстовим шаром. Растеризувати, а потім розпізнавати — це інший продуктовий шлях, ніж об’єднувати цифрові файли.
Якщо потрібні зображення сторінок, це задача конвертації (PDF у зображення), а не об’єднання. Саме змішування цих намірів перетворює «об’єднані» файли на багатомегабайтні фотоальбоми документів. Стиснення після структурного об’єднання все ще може зменшити потоки (Стиснути); воно не скасовує растрового сплющення, яке ви вже впекли.
Чого об’єднання не обіцяє
Об’єднання не вирівнює розміри сторінок, не уніфікує шрифти між файлами й не відбудовує зміст із нуля. Воно не розшифровує зашифровані вхідні файли за вас; якщо джерело захищене паролем, спершу розблокуйте його. Воно не замінює контейнерний формат портфоліо чи пакета, якого очікують деякі судові портали; воно створює один звичайний багатосторінковий PDF.
Ці межі однакові незалежно від того, чи користуєтеся ви браузером, REST, MCP або pdfx. Операція навмисно вузька, щоб вивід лишався передбачуваним для автоматизації. Якщо потрібна впорядкована багатокрокова робота (об’єднати, потім поставити водяний знак, потім стиснути), скористайтеся POST /api/v1/pipeline з упорядкованим списком steps, а не вигадуйте другий прапорець «розумного об’єднання».
Як це запустити
Об’єднати PDF у браузері або POST /api/v1/general/merge-pdfs із повторюваними частинами fileInput (Розробникам). З командного рядка:
pdfx merge a.pdf b.pdf -o merged.pdf
Або проти хмарної чи власної базової адреси:
pdfx --cloud --api-base "$API_BASE" --api-key "$KEY" merge a.pdf b.pdf -o merged.pdf
Анонімні виклики каталогу на публічному сайті не потребують ключа; ключі важливі для стабільної ідентичності автоматизації та для закритих серверів на власному хостингу. Про ту саму операцію через curl і MCP див. Та сама операція, чотири клієнти.