PDF 仍然是文档共享和存档中最受欢迎的格式,因为它的一致性和安全性。将 JPG 转换为 PDF 可以确保您的图像得到保留,易于共享,并可用于专业格式。
JPG转PDF转换的主要好处:
- 维护图像质量和布局的忠实度。
- 确保文件用于分发或长期存储。
- 将多张图片合并为一个文档。
- 使用 .NET REST API 自动化转换过程。
JPG 转 PDF 转换 API
在本文中,我们专注于利用 GroupDocs.Conversion Cloud SDK for .NET 的惊人能力进行 JPEG 到 PDF 的转换。这是一个功能丰富的 API,旨在简化各种文档和图像格式的转换过程。因此,只需几行 C# 代码,您就可以高效地将 JPG 或 JPEG 文件转换为专业质量的 PDF。
入门指南
在开始之前,请确保您拥有以下内容:
- 一个帐户在 GroupDocs Cloud dashboard 以获取 API 凭据。
- 一张用于测试的 JPG 或 JPEG 图片。
- 一个工作的 .NET 环境(Visual Studio、Visual Studio Code 或其他支持的 IDE)。
现在,为了使用 SDK,我们需要将其安装到我们的解决方案中。请在您的 NuGet 包管理器控制台中执行以下命令:
Install-Package GroupDocs.Conversion-Cloud -Version 25.9.0
将 JPEG 转换为 PDF 使用 C#
让我们深入探讨如何使用简单易懂的 C# 代码片段将 JPG 图像转换为 PDF 格式的细节。
第 1 步 - 使用客户端凭据创建 Configuration
和 ConvertApi
对象。
var configurations = new Configuration(clientId, clientSecret1);
var apiInstance = new ConvertApi(configurations);
步骤 2. - 将输入的 JPEG 图像上传到云存储。
fileUpload.UploadFile(new UploadFileRequest("source.jpg", stream));
步骤 3. - 创建 ConvertSettings
的实例,在其中我们将结果格式定义为 PDF。
var settings = new ConvertSettings{...}
步骤 4. - 使用 ConvertDocument(...)
进行 JPEG 到 PDF 的转换。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
// 有关更多示例,请访问 https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet
// 从 https://dashboard.groupdocs.cloud/ 获取客户凭据。
string clientId = "XXXXXX-XXXXXXXXX-XXXXXXX";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// 创建 Configuration 类的实例,同时传递 Client ID 和 Client Secret 作为参数。
var configurations = new Configuration(clientId, clientSecret1);
// 定义 ApiBaseUrl 的值。
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// 使用 Configuration 类的对象初始化 ConvertApi 类的实例。
var convertApi = new ConvertApi(configurations);
// 加载本地驱动器中的输入 JPG 图像。
using (var stream = OpenRead("input.jpg"))
{
// 创建 FileApi 的实例
var fileUpload = new FileApi(configurations);
// upload the input JPEG image to the cloud storage.
fileUpload.UploadFile(new UploadFileRequest("input.jpg", stream));
// 创建 ConvertSettings,其中我们指定结果输出为 PDF。
var settings = new ConvertSettings
{
StorageName = "internal",
FilePath = "input.jpg",
Format = "pdf",
OutputPath = "resultant.pdf"
};
// 调用 ConvertDocument 方法将 JGP 转换为 PDF。
var response = convertApi.ConvertDocument(new ConvertDocumentRequest(settings));
if (response != null && response.Equals("OK"))
{
// print success message
Console.WriteLine("JPG to PDF conversion successfully completed.");
}
}
使用 cURL 将 JPG 保存为 PDF
如果您更喜欢一种轻量级的、可脚本化的解决方案而不需要编写完整的 C# 代码,您还可以使用 cURL 命令与 GroupDocs.Conversion Cloud API。这种方法非常适合自动化、CI/CD 管道或快速测试。
为什么使用 cURL 将 JPG 转换为 PDF?
- 不需要安装SDK。
- 轻松与自动化脚本集成。
- 理想用于服务器端和命令行工作流。
这种方法的前提是根据客户端凭据生成一个 JWT 访问令牌。获取令牌后,请执行以下命令将 JPG 保存为 PDF 格式。
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 "{ \"StorageName\": \"internal\", \"FilePath\": \"{inputFile}\", \"Format\": \"pdf\", \"resultantPath\": \"{myResultant}\"}"
将 {ACCESSTOKEN}
替换为您生成的令牌,将 inputFile
替换为您的 JPG 图像,将 myResultant
替换为要在云存储中生成的结果 PDF 文件的名称。
将结果 PDF 保存到本地驱动器
如果您更喜欢将生成的 PDF 保存在本地驱动器上,请尝试使用以下命令:
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 "{ \"StorageName\": \"internal\", \"FilePath\": \"inputFile\", \"Format\": \"pdf\"}" \
-o "Resultant.pdf"
尝试 JPG 转 PDF 在线(免费应用程序)
如果您想体验 GroupDocs.Conversion Cloud 而无需编写任何代码,可以尝试我们的免费在线 JPG to PDF Converter。这个网络应用程序建立在同一个 REST API 之上,允许您在浏览器中即时将 JPG 或 JPEG 图像转换为 PDF。

有用的资源
总结 remarks
我们已经了解到,使用 GroupDocs.Conversion Cloud SDK for .NET 将 JPG 或 JPEG 图像转换为 PDF 是一个快速、安全和可扩展的解决方案。无论您是在构建文档自动化系统、归档视觉数据,还是将文件转换集成到企业工作流程中,这个 SDK 都能帮助您以最少的代码实现可靠的结果。
常见问题 (FAQs)
- 我需要安装任何额外的软件来执行 JPG 到 PDF 的转换吗?
不。您不需要任何外部软件,API 不依赖于 Adobe Acrobat 或 Microsoft Office 等本地应用程序。
- 我可以将多个 JPG 图像转换为单个 PDF 文档吗?
是的。该 API 支持批量 JPG 转 PDF 转换,允许您将多个 JPG 或 JPEG 图像合并为一个综合的 PDF。只需在转换设置中指定多个文件路径以完成此任务。
- 转换后图像质量是否得以保留?
绝对如此。GroupDocs.Conversion Cloud 在 JPG 转 PDF 转换过程中保持了高图像保真度,确保您的输出 PDF 保留了图像的原始质量、色深和分辨率。
- 支持哪些输出格式除了 PDF?
GroupDocs.Conversion Cloud 支持多种输出格式,包括 DOCX、HTML、XLSX、PPTX 和 PNG,为开发者提供了根据需求将图像和文档转换为多种格式的灵活性。
相关文章
我们强烈推荐您访问以下文章以了解更多信息: