Menggabungkan PDF tanpa meratakan semuanya menjadi gambar

"Gabungkan lima PDF ini" bisa berarti dua alur yang berbeda. Yang pertama menyambung objek halaman yang sudah ada menjadi satu berkas. Yang kedua mencetak setiap halaman ke bitmap lalu mengemas gambar-gambar itu menjadi PDF baru. Keduanya menghasilkan satu lampiran. Hanya jalur pertama yang mempertahankan teks yang bisa dipilih dan vektor yang tajam.

Apa yang dilakukan penggabungan struktural

Di PDF123, Merge menggabungkan dua PDF atau lebih dengan menyambung objek halaman setiap berkas. Jalur server menjalankan qpdf dengan basis kosong dan opsi --pages atas semua masukan: stream halaman berpindah sebagai halaman, bukan sebagai tangkapan layar. Font tertanam, vektor, dan bookmark yang sudah ada ikut berpindah bersama halaman itu. Tidak ada bagian dari jalur ini yang meraster halaman menjadi gambar, sehingga kontrak born-digital tetap bisa dicari dan disalin setelah penggabungan.

Urutan unggahan secara default menjadi urutan hasil. Formulir HTTP menerima bagian fileInput berulang dalam satu permintaan; ukuran batch dibatasi batas unggahan, bukan batas keras dua berkas. Opsi sortType=byFileName menyusun ulang masukan menurut nama berkas sebelum penggabungan. Bookmark dari setiap sumber bisa bertahan; merge tidak menciptakan pohon outline yang sempurna bila masukan aslinya memang tidak punya.

Unggahan satu berkas hanya meneruskan PDF itu apa adanya. Dua berkas atau lebih menjadi satu merged.pdf yang halamannya adalah rangkaian masukan sesuai urutan yang dipilih. Id operasi yang sama itulah yang disediakan OpenAPI, MCP, dan pdfx merge, sehingga skrip dan klik di browser tidak diam-diam berbeda tafsir soal "merge".

Kapan orang tanpa sengaja meraster

Sebagian alur "combine" mengekspor ke gambar lebih dulu (gateway faks, aplikasi pemindai, print-to-PDF pada resolusi layar) atau meratakan anotasi menjadi bitmap sebelum menggabungkan. Ukuran berkas melonjak, OCR mungkin diperlukan lagi, dan saat diperbesar akan terlihat tepi piksel.

Pilih penggabungan stream bila semua sumber sudah berupa PDF digital. Pilih OCR hanya bila masukannya hasil pindai tanpa teks yang berguna, dan ingat bahwa OCR di sini mengembalikan Markdown (text/markdown), bukan PDF dengan lapisan teks tersembunyi yang baru. Meraster lalu menjalankan OCR adalah jalur produk yang berbeda dari menggabungkan berkas born-digital.

Jika yang Anda butuhkan adalah gambar dari halaman, itu pekerjaan konversi (PDF to images), bukan merge. Mencampur kedua maksud itulah yang membuat berkas "hasil merge" berubah menjadi album foto dokumen berukuran banyak megabyte. Compress setelah penggabungan struktural masih bisa mengecilkan stream (Compress); ia tidak membatalkan perataan raster yang sudah Anda lakukan sebelumnya.

Apa yang tidak dijanjikan merge

Merge tidak menyeragamkan ukuran halaman, tidak menyatukan font antarberkas, dan tidak membangun ulang daftar isi dari nol. Ia juga tidak mendekripsi masukan yang terenkripsi untuk Anda; buka kuncinya lebih dulu bila sumbernya dilindungi kata sandi. Merge tidak menggantikan format wadah portfolio atau paket yang diharapkan sebagian portal pengadilan; ia menghasilkan satu PDF multi-halaman biasa.

Batasan itu berlaku sama entah Anda memakai browser, REST, MCP, atau pdfx. Operasi ini sengaja dibuat sempit agar hasilnya tetap dapat diprediksi untuk otomasi. Bila Anda membutuhkan pekerjaan berurutan banyak langkah (merge, lalu watermark, lalu compress), gunakan POST /api/v1/pipeline dengan daftar steps yang berurutan, bukan menciptakan flag "smart merge" kedua.

Cara menjalankannya

Merge PDFs di browser, atau POST /api/v1/general/merge-pdfs dengan bagian fileInput berulang (Developers). Dari shell:

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

Atau terhadap base hosted maupun self-host:

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

Panggilan katalog anonim tidak memerlukan key di situs publik; key diperlukan untuk identitas otomasi yang stabil dan untuk server self-host yang dibatasi. Untuk operasi yang sama lewat curl dan MCP juga, lihat Operasi yang sama, empat klien.