在現代數位生態系統中,將 PDF 文檔轉換為 JPG 圖像的需求比以往任何時候都更加普遍。無論您是想將 PDF 導出為 JPEG、創建文檔預覽,還是將 PDF 轉換為網頁應用程序的圖像格式,自動化都能節省寶貴的時間。
在本指南中,我們將探討如何基於可擴展的 REST API 開發一個穩健的 PDF 轉 JPG 圖像轉換應用程式。
為什麼將 PDF 轉換為 JPG 或 JPEG?
預覽生成– 在網頁應用程式或內容系統中顯示 PDF 頁面作為圖像。輕鬆分享– JPG 圖片在各種設備上都具通用性。高保真– 保留顏色、佈局和向量圖形。自動化就緒– 完美適用於後端文件處理。可擴展性– 輕鬆地批量將多個 PDF 文件轉換為 JPG。
PDF 轉換 REST API
The GroupDocs.Conversion Cloud SDK for .NET 提供了一個基於雲端的解決方案來將 PDF 轉換為 JPG,以及許多其他格式。它支持 數十種文檔和圖像類型,為您提供了一種簡便的方法,直接從 .NET 應用程序將 PDF 匯出為 JPEG 或其他文件類型。
開始使用
在我們開始轉換過程之前,請確保您已經:
- 一個 GroupDocs Cloud account,具有 Client ID 和 Client Secret。
- A sample PDF file to test conversion.
- 已配置的 .NET 環境(Visual Studio、Visual Studio Code 或其他支援的 IDE)。
透過 NuGet 套件管理器安裝 SDK:
Install-Package GroupDocs.Conversion-Cloud -Version 25.9.0
如何在 C# 中將 PDF 轉換為 JPG
按照以下簡單步驟使用 .NET REST API 將 PDF 轉換為影像(JPG)格式:
步驟 1. - 創建 Configuration、ConvertApi 和 FileApi 類的實例。
var configurations = new Configuration(clientId, clientSecret1);
var convertApi = new ConvertApi(configurations);
var fileApi = new FileApi(configuration);
步驟 2. - 將 PDF 檔案上傳至雲端儲存。
using (var fileStream = File.OpenRead("sample.pdf"))
{
var uploadRequest = new UploadFileRequest("sample.pdf", fileStream);
fileApi.UploadFile(uploadRequest);
}
步驟 3. - 定義 ConvertSettings 以進行 PDF → JPG 轉換。
var settings = new ConvertSettings
{
FilePath = "input.pdf",
Format = "jpg",
OutputPath = "converted/pdf-to-jpg/"
};
步驟 4. - 使用 ConvertDocument(...) 方法來啟動 PDF 到 JPG 的轉換。
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);
- PDF 文檔中的每一頁都被轉換成一個單獨的 JPG 圖像,並存儲在輸出文件夾中。
// 如需更多範例,請訪問 https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// 從 https://dashboard.groupdocs.cloud/ 獲取客戶憑證
string clientId = "XXXXXX-XXXXXXXXX-XXXXXXX";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// 創建一個 Configuration 類的實例,並將客戶端 ID 和客戶端密鑰作為參數傳遞。
var configurations = new Configuration(clientId, clientSecret1);
// 定義 ApiBaseUrl 的值。
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// 初始化一個 ConvertApi 類的實例,並使用 Configuration 類的物件。
var convertApi = new ConvertApi(configurations);
// 創建 FileApi 的實例
var fileApi = new FileApi(configuration);
// load the input PDF from local drive.
using (var stream = OpenRead("sample.pdf"))
{
// upload the input PDF to the cloud storage.
fileApi.UploadFile(new UploadFileRequest("sample.pdf", stream));
// 創建 ConvertSettings,指定結果輸出為 JPEG。
var settings = new ConvertSettings
{
StorageName = "internal",
FilePath = "sample.pdf",
Format = "jpg",
OutputPath = "converted/pdf-to-jpg/"
};
// 調用 ConvertDocument 方法將 PDF 頁面導出為 JPEG 圖像。
var response = convertApi.ConvertDocument(new ConvertDocumentRequest(settings));
if (response != null && response.Equals("OK"))
{
// print success message
Console.WriteLine("PDF to JPEG images conversion completed successfully.");
}
}
使用 cURL 將 PDF 轉換為 JPEG
如果您更喜歡基於腳本的方法,您也可以使用 GroupDocs.Conversion Cloud REST API 和 cURL 將 PDF 轉換為 JPG。
為什麼使用 cURL 進行 PDF 轉 JPG 轉換?
- 適合自動化管道或 CI/CD 整合。
- 不需要安裝 SDK。
- 適合無頭或伺服器環境。
首先,使用客戶端憑證生成您的 JWT 訪問令牌,然後執行以下命令將 PDF 導出為 JPEG 圖像格式:
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d "{ \"FilePath\": \"{inputFile}\", \"Format\": \"jpg\", \"LoadOptions\": { \"Format\": \"JPG\" },\"OutputPath\": \"{resultantFile}\"}"
將 {ACCESSTOKEN} 替換為 JWT 令牌,inputFile 替換為 PDF 文件的名稱,resultantFile 替換為要在雲端儲存中生成的結果 JPEG 圖像的名稱。
嘗試 JPG 轉 PDF 在線(免費應用程式)
如果你想在不編碼的情況下探索這個功能,可以嘗試我們的免費 PDF to JPG Converter 網頁應用。它允許你立即在瀏覽器中導出 PDF 為 JPEG,並由同樣的 GroupDocs.Conversion Cloud API 驅動。

有用的資源
結論
總結來說,使用 GroupDocs.Conversion Cloud SDK for .NET 將 PDF 轉換為 JPG 為開發者和企業提供了一個高效且可靠的解決方案。無論您是在構建自動化的文件管理系統,還是希望將 PDF 文件轉換為 JPG 以便更方便的共享、存檔或生成預覽,這個 API 都使過程變得毫不費力。
常見問題 (FAQs)
Q. 我可以一次將多個 PDF 文件轉換為圖像嗎?
- A. 是的。該 API 支援批量 PDF 轉 JPG 轉換,允許您同時處理多個 PDF。
Q. 轉換後的 JPG 圖片質量如何?
- A. 此 SDK 確保高保真輸出,在將 PDF 匯出為圖像格式時保持文本清晰度、向量圖形和顏色準確性。
Q. 是否需要額外的軟體,如 Adobe Acrobat?
- A. 不。 .NET REST API 完全在雲端運行,不需要本地安裝或第三方軟體。
相關文章
我們強烈建議您參閱以下文章以了解更多:
