把 PDF 轉成 JPG 或 PNG：DPI 改變了什麼，以及如何匯出單一頁

PDF 轉圖片會把 PDF 的每一頁各轉成一個圖片檔，並以 ZIP 回傳。瀏覽器表單有兩個設定，格式（PNG 或 JPEG）和 DPI，沒有辦法挑選頁面，也不能選 WebP。這兩個設定都會大幅改變輸出大小，以下各節會說明差多少。

實例：六頁，四種設定

測試檔是用 Ghostscript 產生的 6 頁、美國 Letter 尺寸、純文字文件：每頁 32 行 11 pt Times，共 5,593 位元組。它被送到本機建置伺服器的 /api/v1/convert/pdf/img 端點，每種設定各一次。數字來自 2026-10-04 的一次執行；換一份文件，大小會不同。

像素尺寸由頁面大小決定：Letter 頁面是 8.5 乘 11 英寸，所以 150 DPI 是 1275 乘 1650，300 DPI 是 2550 乘 3300。DPI 加倍，像素數變成四倍，但這裡 PNG 的 ZIP 只增加約 2.5 倍，因為平坦的白色區域很好壓縮。

就這份檔案而言，JPEG 比 PNG 大：150 DPI 時第 1 頁約是 4.7 倍。「JPEG 是小檔格式」這個常見說法，適用於照片。文字頁大部分是平坦的白色加上銳利的邊緣，PNG 壓得好，JPEG 壓不好。照片類或掃描的頁面可能反過來，所以在轉一百頁之前，先拿一頁有代表性的來測試。

ZIP 以 PDF 的名稱命名（contract.pdf 得到 contract.zip），裡面是 page.1.png 到 page.6.png，選擇 JPEG 時則是 .jpg 檔。

API 接受但會忽略的選項

瀏覽器表單沒有提供這兩項，但送出它們的指令碼不會得到錯誤，也不會有任何作用：

• 頁面選擇。 送出 pageNumbers=2 回傳了全部六頁，不是一頁。每一頁一律都會被轉換。
• WebP。 imageFormat=webp 回傳的是 PNG 檔，檔名和大小都與 png 相同。只有 jpeg 和 jpg 會選到 JPEG；其他任何值都退回 PNG。

如果需要 WebP，請事後在影像編輯器裡轉換 PNG 檔。

取得單一頁

先把那一頁切出來，再轉換這份一頁的 PDF：

1. 開啟擷取頁面，上傳 PDF，輸入 2 作為要保留的頁。測試中的結果是一份 1 頁的 PDF。
2. 把那份 PDF 上傳到PDF 轉圖片，DPI 設為 150，保持 PNG。ZIP 裡有一個檔案，page.1.png。

即使它來自原檔的第 2 頁，檔名仍是 page.1.png，因為擷取出的 PDF 重新從 1 開始編號。如果原本的頁碼很重要，請自行改名。

DPI：表單與 API 不一致的地方

網頁表單預設填入 300。直接呼叫 API 而省略 dpi 時，以 150 轉換。如果指令碼產生的圖片比瀏覽器的小，原因就在這裡；兩邊都請明確送出 dpi。非數字的值會被以 400 拒絕，訊息是「dpi must be a number」。

粗略的建議，依據是上面的表格，而不是任何畫質基準測試：150 DPI 足以在螢幕上閱讀整頁；300 DPI 適用於列印，或放大看細小的字。這次測試中，300 DPI 的 PNG ZIP 約是 150 DPI 的 2.5 倍，而掃描量大的長文件會把這個差距再放大。

什麼不會保留

結果是像素，所以：

• 文字不再能選取或搜尋。要文字，請用PDF 轉文字，掃描檔則用OCR 轉 Markdown。
• 連結失效。
• 向量標誌和圖表會依你選的 DPI 轉成點陣圖，之後放大會變模糊。請改用更高的 DPI 重跑。

請把原始 PDF 和圖片放在一起。之後用圖片轉 PDF轉回去，得到的是由文字的圖片組成的 PDF，而不是原本的文件。

受密碼保護的 PDF 會被以 400 拒絕，訊息為 This PDF is password-protected. Enter its password.，送到這個端點的 password 欄位也無法改變結果。請先用移除密碼移除密碼。

大量使用這組圖片之前先檢查

從 ZIP 裡開啟一頁，以 100% 縮放檢查小字和細線。如果偏軟，就提高 DPI 重跑；如果 ZIP 太大，就降低 DPI，或是確認 JPEG 對你的頁面確實比較小之後，才改用 JPEG。