PPDF123
Productอ่านประมาณ 1 นาที

pdfx CLI: แคตตาล็อกเดียว เรียกจากเทอร์มินัลของคุณ

pdfx CLI ส่งคำขอ multipart แบบเดียวกับ curl ไปยัง API ของ PDF123 หรือ pdfx-server ของคุณเอง พร้อมเพิ่มการรันแบบกลุ่ม รหัสผ่านรายไฟล์ และรหัสออกที่สคริปต์ใช้ตัดสินใจได้

By the PDF123 team · Updated 2026-09-29
pdfx CLI: แคตตาล็อกเดียว เรียกจากเทอร์มินัลของคุณ

PDF123 คือชื่อผลิตภัณฑ์ ส่วน pdfx คือแคตตาล็อกการดำเนินการชุดเดียวกันที่ห่อมาเพื่อเชลล์ มันสร้างคำขอ multipart แบบเดียวกับที่ curl จะสร้าง ส่งไปยัง base URL ที่คุณเลือก และเขียนผลลัพธ์ไว้ข้างไฟล์ของคุณ รวมไฟล์ บีบอัด OCR และเครื่องมืออื่นในแคตตาล็อกเรียกใช้แบบนี้ได้

การเรียกหนึ่งครั้งส่งอะไรจริง ๆ

pdfx --api-base "$API_BASE" --api-key "$PDFX_API_KEY" \
  merge a.pdf b.pdf -o merged.pdf

--api-base มีค่าเริ่มต้นเป็น https://pdf123.xyz และ --api-key (หรือตัวแปรสภาพแวดล้อม PDFX_API_KEY) เป็นตัวเลือก จึงใช้แคตตาล็อกแบบไม่ระบุตัวตนได้โดยไม่ต้องมีคีย์ ชี้ base ไปที่ http://127.0.0.1:8080 สำหรับสแตก docker-compose ของคุณเอง ไม่มีโปรโตคอลที่สองอยู่ข้างใต้ CLI เป็นไคลเอนต์ของพื้นผิว REST ที่อธิบายใน Developers และชื่อ op ตรงกับเครื่องมือในพอร์ทัลและเอกสาร OpenAPI ที่ /v1/openapi.json

สำรวจแคตตาล็อกได้โดยไม่ต้องออกจากเทอร์มินัล pdfx list พิมพ์ทุกเครื่องมือ และ pdfx describe add-stamp พิมพ์ฟิลด์และค่าเริ่มต้นของเครื่องมือหนึ่งตัว ซึ่งเป็นนิยามเดียวกับที่พอร์ทัลเรนเดอร์เป็นฟอร์ม

การรันแบบกลุ่ม และ flag ที่ curl บังคับให้คุณเขียนเอง

ให้เครื่องมือแบบไฟล์เดียวรับอินพุตหลายไฟล์ แล้วมันจะรันเป็นกลุ่มไปยังไดเรกทอรี -o พิมพ์บรรทัด input -> saved หนึ่งบรรทัดต่อไฟล์ ความล้มเหลวไปที่ stderr และไฟล์ที่เหลือยังคงทำจนจบ PDF เสียหายหนึ่งไฟล์ในกองใบแจ้งหนี้จึงไม่ทำให้การรันหยุดกลางคัน --concurrency <n> กำหนดจำนวนไฟล์ที่ทำงานพร้อมกัน (ค่าเริ่มต้น 2)

-o รับได้ทั้งไฟล์และไดเรกทอรี และไม่เขียนทับไฟล์ที่มีอยู่ โดยใช้ชื่อไฟล์จากเซิร์ฟเวอร์ภายในไดเรกทอรีแทน เรื่องนี้สำคัญเมื่อเซิร์ฟเวอร์ตั้งชื่อผลลัพธ์ตามอินพุต ถ้าไม่มีกฎนี้ การรันจะทับ PDF ที่คุณเพิ่งอัปโหลด

ไฟล์อินพุตที่เข้ารหัสจะถูกเปิดก่อนส่งคำขอ ไม่ใช่โดยเครื่องมือ --input-password ครอบคลุมทุกไฟล์ในการรัน และ --password-for report.pdf=secret ตั้งรหัสผ่านของไฟล์เดียวและใส่ซ้ำได้ โดย * แทนไฟล์ที่เหลือ กลุ่มที่ปนไฟล์ล็อกกับไฟล์เปิดจึงไม่ต้องจัดเรียงเอง --json พิมพ์ { path, contentType, bytes } ต่อผลลัพธ์ หรือ [{ input, ok, path | error, reason }] สำหรับกลุ่ม ตัวห่อจึงแยกวิเคราะห์ผลได้แทนที่จะดึงข้อความที่มนุษย์อ่าน

รหัสออกที่สคริปต์ใช้ตัดสินใจ

0 คือสำเร็จ 1 คือคำขอล้มเหลว (ในกลุ่ม: อย่างน้อยหนึ่งไฟล์) 2 คือข้อผิดพลาดการใช้งานที่ยังไม่ได้อัปโหลดอะไร และ 130 คือคุณขัดจังหวะและคำขอที่ค้างอยู่ถูกยกเลิก ความล้มเหลวพิมพ์บรรทัด reason: code: และ hint: ใต้ข้อความเมื่อมี ซึ่งเป็นสิ่งที่สคริปต์ควรจับคู่ ไม่ใช่ข้อความบรรยาย

มีรหัสหนึ่งที่อ่านผิดได้ง่าย เครื่องมือที่หาอะไรจะคืนไม่ได้จะออกด้วยรหัสที่ไม่ใช่ศูนย์พร้อม code: no_content แทนที่จะเขียนไฟล์เปล่า pdf-to-csv บน PDF ที่ไม่มีตารางจึงเป็นความล้มเหลว ไม่ใช่ CSV ขนาดศูนย์ไบต์

ไบต์ไปที่ไหน

ไฟล์ถูกอัปโหลดไปยัง base URL ประมวลผลที่นั่น และลบทิ้งเมื่อส่งคำตอบแล้ว นั่นคือสัญญาเดียวกับฟอร์มในเบราว์เซอร์ CLI เปลี่ยนไคลเอนต์ ไม่ได้เปลี่ยนปลายทาง สำหรับเอกสารที่ห้ามออกจากเครือข่ายของคุณ ให้รัน pdfx-server เองแล้วชี้ --api-base ไปที่มัน ซึ่งอธิบายไว้ที่ Self-host

ไม่มีโหมดออฟไลน์ให้ถอยกลับ ถ้า base เข้าถึงไม่ได้ คำสั่งก็ล้มเหลว pdfx เป็นไคลเอนต์เครือข่ายที่บังเอิญใช้ในเชลล์ได้สบาย ไม่ใช่เอนจิน PDF ในเครื่อง

CLI ไม่ใช่อะไร

pdfx ไม่ใช่ GUI เดสก์ท็อป และไม่ใช่ไลบรารี OCR ที่ฝังในแอปอื่น มันคือไคลเอนต์บรรทัดคำสั่งสำหรับงาน PDF งานมือแบบครั้งเดียวจึงยังเหมาะกับพอร์ทัลมากกว่า (บีบอัด OCR และเครื่องมืออื่นในแคตตาล็อก) และอะไรก็ตามที่ต้องการโครง UI ของตัวเองจะสร้างปัญหาเรื่องความคลาดเคลื่อนที่อธิบายใน ปฏิบัติการเดียวกัน สี่ไคลเอนต์

เอเจนต์ได้รูปทรงเดียวกันจากสกิลที่เผยแพร่ที่ /skills/pdf123.md ซึ่งอธิบายคำขอ merge และ pipeline อย่างครบถ้วน สำหรับการลองใหม่ที่ปลอดภัยของ POST ที่เปลี่ยนสถานะ ให้ส่ง Idempotency-Key CLI ยังคงส่งหนึ่งคำขอต่อการเรียกหนึ่งครั้ง เฮดเดอร์นี้จึงเป็นของตัวห่อที่ลองใหม่ (Idempotency-Key: การลองใหม่ที่ปลอดภัยสำหรับงาน PDF) คีย์ ข้อจำกัดอัตรา และรหัสข้อผิดพลาดอยู่ที่ Developers

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool
Read next
แก้ไขข้อความใน PDF ออนไลน์: แก้ได้แม้ไม่มีไฟล์ต้นฉบับ
คลิกข้อความหนึ่งบรรทัดใน PDF แก้ไข แล้วดาวน์โหลดผลลัพธ์ได้เลย ไฟล์ไม่ถูกอัปโหลดและไม่ต้องลงชื่อเข้าใช้ แก้ไขได้เฉพาะบรรทัดข้อความที่มีอยู่แล้วเท่านั้น
Idempotency-Key: การลองใหม่ที่ปลอดภัยสำหรับงาน PDF
ส่ง Idempotency-Key บนงาน POST ใต้ /api/v1/ ระบบแคชคำตอบที่สำเร็จไว้ 24 ชั่วโมงในหน่วยความจำของโปรเซส และตั้ง Idempotency-Replayed: true แทนการรันซ้ำสองครั้ง
แพ็กสแกนเป็นข้อความ: OCR แล้ว Compress PDF ที่คุณยังเก็บ
แพ็กสแกนต้องทำสองขั้นตอน: OCR บน PDF123 คืนข้อความ Markdown ขณะที่ Compress ย่อ PDF ต้นฉบับด้วยการบีบอัดสตรีมใหม่ ลำดับและเอาต์พุตจึงต่างกัน