在 Python 中使用 REST API 將圖像轉換為 PDF

PDF 是用於共享和打印文檔的流行格式之一。我們經常需要將不同格式的文檔和圖片轉換成PDF。開發此類工具需要大量時間和精力。因此,最好使用已經開發的專用工具,這些工具可以為您的需求提供易於維護、靈活的解決方案。為此,圖像到 PDF 的轉換 REST API 和 Python SDK 允許在雲端以編程方式將支持的格式 文檔轉換為 PDF。在本文中,我們將學習如何使用 Python 中的 REST API 將圖像轉換為 PDF。

本文應涵蓋以下主題:

圖像到 PDF 轉換 REST API 和 Python SDK

為了將 JPGPNG 圖像轉換為 PDF,我們將使用 GroupDocs.Conversion Cloud 的 Python SDK API。請在控制台中使用以下命令安裝它:

pip install groupdocs_converison_cloud

在執行上述步驟之前,請從儀表板獲取您的客戶端 ID 和密碼。獲得 ID 和密碼後,添加如下所示的代碼:

# 此代碼示例演示如何設置客戶端 ID 和密碼。
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

configuration = groupdocs_conversion_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

在 Python 中使用 REST API 將 JPG 轉換為 PDF

我們可以按照下面給出的簡單步驟將圖像轉換為 PDF 文檔:

  1. 上傳JPG圖片文件至雲端
  2. 使用 Python 將 JPG 轉換為 PDF
  3. 下載轉換後的PDF文件

上傳圖片

首先,我們將使用以下代碼示例將 JPG 圖像文件上傳到雲端:

# 此代碼示例演示如何將 JPG 圖像文件上傳到雲端。
# 創建 API 實例
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# 上傳文件請求
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)

# 上傳示例文件
response = file_api.upload_file(request)

因此,上傳的文件將在雲端儀表板的 文件部分 中可用。

使用 Python 將 JPG 轉換為 PDF

我們可以按照以下步驟以編程方式將 JPG 圖像轉換為 PDF 文檔:

  • 首先,創建一個 ConvertApi 的實例。
  • 接下來,創建 ConvertSettings 的實例。
  • 然後,設置JPG 文件路徑。
  • 並且,將“pdf”分配給格式。
  • 另外,提供輸出文件路徑。
  • 之後,使用 ConvertSettings 作為參數創建 ConvertDocumentRequest。
  • 最後用ConvertDocumentRequest調用ConvertApi.convert\document()方法保存轉換後的文件。

以下代碼示例展示瞭如何在 Python 中使用 REST API 將 JPG 圖像轉換為 PDF 文檔。

# 此代碼示例演示如何將 JPT 轉換為 PDF。
# 創建必要的 API 實例
轉變_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# 準備轉換設置
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "轉變ed"

# 轉換請求
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# 轉變
result = 轉變_api.轉變_document(request)

# 完畢
print("Document 轉變ed: " + result[0].path)
在 Python 中使用 REST API 將 JPG 轉換為 PDF。

在 Python 中使用 REST API 將 JPG 轉換為 PDF。

下載轉換後的 PDF

上面的代碼示例會將轉換後的 PDF 文檔保存在雲端。可以使用以下代碼示例下載它:

# 此代碼示例演示如何從雲端下載 PDF 文件。
# API初始化
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# 下載文件請求
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# 下載文件
response = file_api.download_file(request)

# 將下載的文件移動到您的工作目錄
shutil.move(response, "C:\\Files\\Conversion\\")

使用高級選項將 JPG 轉換為 PDF

我們可以按照以下給出的步驟以編程方式將 JPG 轉換為具有一些高級設置的 PDF 文檔:

  • 首先,創建一個 ConvertApi 的實例。
  • 接下來,創建 ConvertSettings 的實例。
  • 然後,設置JPG 文件路徑。
  • 並且,將“pdf”分配給格式。
  • 另外,提供輸出文件路徑。
  • 接下來,創建 PdfConvertOptions 的實例並分配給 ConvertSettings。
  • 然後,設置各種轉換設置,如 dpi、灰度、圖像\質量、高度、邊距(頂部、左側、右側、底部)等。
  • 之後,使用 ConvertSettings 作為參數創建 ConvertDocumentRequest。
  • 最後用ConvertDocumentRequest調用ConvertApi.convert\document()方法保存轉換後的文件。

以下代碼示例顯示如何使用高級轉換選項將 JPG 圖像轉換為 PDF 文檔。請按照前面提到的步驟上傳 JPG 圖像文件並下載轉換後的 PDF 文件。

# 此代碼示例演示如何使用高級選項將 JPT 轉換為 PDF。
# 創建必要的 API 實例
轉變_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# 準備轉換設置
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "轉變ed_with_options.pdf"

# PDF 轉換選項
轉變Options = groupdocs_conversion_cloud.PdfConvertOptions()
轉變Options.center_window = True
轉變Options.display_doc_title = True
轉變Options.dpi = 1024.0
轉變Options.fit_window = False
轉變Options.grayscale = True
轉變Options.image_quality = 100
轉變Options.linearize = True
轉變Options.margin_top = 500
轉變Options.margin_left = 500
轉變Options.margin_right = 500
轉變Options.margin_bottom = 500

settings.轉變_options = 轉變Options

# 轉換請求
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# 轉變
result = 轉變_api.轉變_document(request)

# 完畢
print("Document 轉變ed: " + result[0].path)
使用高級選項將 JPG 轉換為 PDF。

使用高級選項將 JPG 轉換為 PDF。

在 Python 中使用水印將 JPG 轉換為 PDF

我們可以將 JPG 轉換為 PDF 文檔,然後按照以下步驟以編程方式向轉換後的 PDF 添加水印:

  • 首先,創建一個 ConvertApi 的實例。
  • 接下來,創建 ConvertSettings 的實例。
  • 然後,設置 JPG 文件路徑,指定“pdf”格式並提供輸出文件路徑。
  • 接下來,創建 WatermarkOptions 的一個實例。
  • 然後,設置水印文字、顏色、字體\大小、旋轉\角度等。
  • 接下來,創建 PdfConvertOptions 的實例並分配給 WatermarkOptions。
  • 然後,可選擇設置各種轉換設置。
  • 並且,將 PdfConvertOptions 分配給 ConvertSettings。
  • 之後,使用 ConvertSettings 作為參數創建 ConvertDocumentRequest。
  • 最後用ConvertDocumentRequest調用ConvertApi.convert\document()方法保存轉換後的文件。

以下代碼示例顯示如何使用 Python 中的 REST API 將 JPG 轉換為 PDF 文檔並向轉換後的 PDF 文檔添加水印。

# 此代碼示例演示如何將 JPT 轉換為 PDF 以及如何向轉換後的 PDF 添加水印。
# 接口初始化
convert_api = groupdocs_conversion_cloud.轉變Api.from_keys(client_id, client_secret)

# 定義轉換設置
settings = groupdocs_conversion_cloud.轉變Settings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"

# 定義水印選項
watermark = groupdocs_conversion_cloud.WatermarkOptions()
watermark.text = "THIS IS SAMPLE WATERMARK"
watermark.bold = True;
watermark.font_size = 34;
watermark.color = "Black";
watermark.background = False;
watermark.rotation_angle = 30;
watermark.left = 90;
watermark.top = 500;

# 定義 PDF 轉換選項
convertOptions = groupdocs_conversion_cloud.Pdf轉變Options()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# 創建轉換文檔請求
request = groupdocs_conversion_cloud.轉變DocumentRequest(settings)
# 轉變
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
在 Python 中使用水印將 JPG 轉換為 PDF。

在 Python 中使用水印將 JPG 轉換為 PDF。

將 JPG 轉換為 PDF 並直接下載文件

我們可以通過編程方式將 JPG 轉換為 PDF,並按照以下步驟直接下載轉換後的 PDF 文件:

  • 首先,創建一個 ConvertApi 的實例。
  • 接下來,創建 ConvertSettings 的實例。
  • 然後,設置JPG 文件路徑。
  • 並且,將“pdf”分配給格式。
  • 此外,將輸出文件路徑提供為無。
  • 之後,使用 ConvertSettings 作為參數創建 ConvertDocumentRequest。
  • 最後,使用 ConvertDocumentRequest 調用 ConvertApi.convert\document\download() 方法將轉換後的文件保存到本地磁盤。

以下代碼示例顯示瞭如何將 JPG 圖像文件轉換為 PDF 文檔並使用 Python 中的 REST API 直接下載它。 API 應返迴轉換後的 PDF 文件作為響應。請按照前面提到的步驟上傳文件。

# 此代碼示例演示如何轉換和下載。
# 創建必要的 API 實例
convert_api = groupdocs_conversion_cloud.轉變Api.from_keys(client_id, client_secret)

# 準備轉換設置
settings = groupdocs_conversion_cloud.轉變Settings()
settings.file_path = "sample.jpg"
settings.format = "pdf"

settings.output_path = None    # leave OutputPath will result the output as document IOStream

# 準備請求
request = groupdocs_conversion_cloud.轉變DocumentRequest(settings)

# 轉變
response = convert_api.convert_document_download(request)

# 將下載的文件移動到您的工作目錄
shutil.move(response, "C:\\Files\\Conversion\\")

不使用雲存儲的 JPG 到 PDF 轉換

我們可以按照以下步驟在不使用雲存儲的情況下將 JPG 轉換為 PDF:

  • 首先,創建一個 ConvertApi 的實例
  • 接下來,以目標格式和輸入圖像文件路徑作為參數創建 ConvertDocumentDirectRequest。
  • 然後,以 ConvertDocumentDirectRequest 作為參數調用 convert\document\direct() 方法。
  • 最後,使用 FileStream.writeFile() 方法將轉換後的輸出 PDF 文件保存到本地路徑。

以下代碼示例顯示瞭如何在不使用雲存儲的情況下將 JPG 轉換為 PDF 文檔。這意味著我們將在請求正文中傳遞輸入文件,並在 API 響應中接收輸出文件。

# 此代碼示例演示如何在不使用雲存儲的情況下將 JPT 轉換為 PDF。
# 創建必要的 API 實例
convert_api = groupdocs_conversion_cloud.轉變Api.from_keys(client_id, client_secret)

# 準備請求
request = groupdocs_conversion_cloud.轉變DocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")

# 轉變
result = convert_api.convert_document_direct(request)

# 將下載的文件移動到您的工作目錄
shutil.move(result, "C:\\Files\\Conversion\\")

在線試用

請試用以下使用上述API開發的免費在線JPG轉換工具。 https://products.groupdocs.app/conversion/

結論

在本文中,我們學習瞭如何在雲端將 JPG 文件轉換為 PDF 文件。我們還了解瞭如何使用 Python 將 JPG 轉換為 PDF 並為轉換後的文檔添加水印。本文還介紹瞭如何以編程方式將 JPG 圖像文件上傳到雲端,然後從雲端下載轉換後的 PDF 文件。此外,您可以使用 文檔 了解有關 GroupDocs.Conversion Cloud API 的更多信息。我們還提供了一個 API 參考 部分,讓您可以直接通過瀏覽器可視化我們的 API 並與之交互。如有任何歧義,請隨時在論壇上與我們聯繫。

也可以看看