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 并与之交互。如有任何歧义,请随时在论坛上与我们联系。