PDF 是用於共享和打印文檔的流行格式之一。我們經常需要將不同格式的文檔和圖片轉換成PDF。開發此類工具需要大量時間和精力。因此,最好使用已經開發的專用工具,這些工具可以為您的需求提供易於維護、靈活的解決方案。為此,圖像到 PDF 的轉換 REST API 和 Python SDK 允許在雲端以編程方式將支持的格式 文檔轉換為 PDF。在本文中,我們將學習如何使用 Python 中的 REST API 將圖像轉換為 PDF。
本文應涵蓋以下主題:
- 圖像到 PDF 轉換 REST API 和 Python SDK
- 在 Python 中使用 REST API 將 JPG 轉換為 PDF
- 使用高級選項將 JPG 轉換為 PDF
- 在 Python 中使用水印將 JPG 轉換為 PDF
- 將 JPG 轉換為 PDF 並直接下載文件
- 不使用雲存儲的 JPG 到 PDF 轉換
圖像到 PDF 轉換 REST API 和 Python SDK
為了將 JPG 或 PNG 圖像轉換為 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 文檔:
- 上傳JPG圖片文件至雲端
- 使用 Python 將 JPG 轉換為 PDF
- 下載轉換後的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)
下載轉換後的 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)
在 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)
將 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 並與之交互。如有任何歧義,請隨時在論壇上與我們聯繫。