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

也可以看看