Преобразование изображений в PDF с помощью REST API в Python

PDF — один из популярных форматов для обмена и печати документов. Нам часто нужно конвертировать документы разных форматов и изображения в PDF. Разработка таких инструментов требует много времени и усилий. Так что лучше использовать уже разработанные специализированные инструменты, которые обеспечивают легкое в сопровождении, гибкое решение для ваших нужд. С этой целью REST API преобразования изображений в PDF и Python SDK позволяют программно преобразовывать документы поддерживаемых форматов в PDF в облаке. В этой статье мы узнаем, как конвертировать изображения в PDF с помощью REST API в Python.

В этой статье должны быть раскрыты следующие темы:

Преобразование изображений в PDF REST API и Python SDK

Для преобразования изображений JPG или PNG в PDF мы будем использовать Python SDK of GroupDocs.Conversion Cloud API. Пожалуйста, установите его с помощью следующей команды в консоли:

pip install groupdocs_converison_cloud

Пожалуйста, получите свой идентификатор клиента и секрет из панели управления, прежде чем выполнять указанные шаги. Получив свой идентификатор и секрет, добавьте код, как показано ниже:

# В этом примере кода показано, как установить идентификатор клиента и секрет.
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 = ""

Преобразование JPG в PDF с помощью REST API в Python

Мы можем конвертировать изображения в документы PDF, выполнив простые шаги, указанные ниже:

  1. Загрузить файл изображения JPG в облако
  2. Конвертировать JPG в PDF с помощью Python
  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)

В результате загруженный файл будет доступен в разделе файлов панели инструментов в облаке.

Преобразование JPG в PDF с помощью Python

Мы можем программно конвертировать изображения JPG в документы PDF, выполнив следующие действия:

  • Во-первых, создайте экземпляр ConvertApi.
  • Затем создайте экземпляр ConvertSettings.
  • Затем укажите путь к файлу JPG.
  • И назначьте «pdf» для формата.
  • Также укажите путь к выходному файлу.
  • После этого создайте ConvertDocumentRequest с ConvertSettings в качестве аргумента.
  • Наконец, вызовите метод ConvertApi.convert\document() с ConvertDocumentRequest, чтобы сохранить преобразованный файл.

В следующем примере кода показано, как преобразовать изображение JPG в документ PDF с помощью REST API в Python.

# В этом примере кода показано, как преобразовать 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)
Преобразование JPG в PDF с помощью REST API в Python.

Преобразование JPG в PDF с помощью REST API в Python.

Загрузите конвертированный 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, оттенки серого, изображение\качество, высота, поля (сверху, слева, справа, снизу) и т. д.
  • После этого создайте ConvertDocumentRequest с ConvertSettings в качестве аргумента.
  • Наконец, вызовите метод ConvertApi.convert\document() с ConvertDocumentRequest, чтобы сохранить преобразованный файл.

В следующем примере кода показано, как преобразовать изображение 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 с дополнительными параметрами.

Преобразование JPG в PDF с водяным знаком в Python

Мы можем преобразовать документ JPG в PDF, а затем программно добавить водяной знак в преобразованный PDF, выполнив следующие действия:

  • Во-первых, создайте экземпляр ConvertApi.
  • Затем создайте экземпляр ConvertSettings.
  • Затем установите путь к файлу JPG, назначьте формат «pdf» и укажите путь к выходному файлу.
  • Затем создайте экземпляр WatermarkOptions.
  • Затем установите текст водяного знака, цвет, шрифт\размер, поворот\угол и т. д.
  • Затем создайте экземпляр PdfConvertOptions и назначьте WatermarkOptions.
  • Затем при желании установите различные параметры преобразования.
  • И назначьте PdfConvertOptions для ConvertSettings.
  • После этого создайте ConvertDocumentRequest с ConvertSettings в качестве аргумента.
  • Наконец, вызовите метод ConvertApi.convert\document() с ConvertDocumentRequest, чтобы сохранить преобразованный файл.

В следующем примере кода показано, как преобразовать JPG в документ PDF и добавить водяной знак в преобразованный документ PDF с помощью REST API в Python.

# В этом примере кода показано, как преобразовать JPT в PDF и добавить водяной знак в преобразованный 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 = "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 с водяным знаком в Python.

Конвертируйте JPG в PDF с водяным знаком в Python.

Преобразование JPG в PDF и загрузка файла напрямую

Мы можем программно преобразовать JPG в PDF и загрузить преобразованный PDF-файл напрямую, выполнив следующие действия:

  • Во-первых, создайте экземпляр ConvertApi.
  • Затем создайте экземпляр ConvertSettings.
  • Затем укажите путь к файлу JPG.
  • И назначьте «pdf» для формата.
  • Кроме того, укажите путь к выходному файлу как None.
  • После этого создайте ConvertDocumentRequest с ConvertSettings в качестве аргумента.
  • Наконец, вызовите метод ConvertApi.convert\document\download() с ConvertDocumentRequest, чтобы сохранить преобразованный файл на локальном диске.

В следующем примере кода показано, как преобразовать файл изображения JPG в документ PDF и загрузить его напрямую с помощью REST API в Python. В ответ 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 с целевым форматом и путем к входному файлу изображения в качестве аргументов.
  • Затем вызовите метод convert\document\direct() с ConvertDocumentDirectRequest в качестве аргумента.
  • Наконец, сохраните преобразованный выходной PDF-файл по локальному пути, используя метод FileStream.writeFile().

В следующем примере кода показано, как преобразовать 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\\")

Попробуйте онлайн

Пожалуйста, попробуйте следующий бесплатный онлайн-инструмент преобразования JPG, который разработан с использованием вышеуказанного API. https://products.groupdocs.app/conversion/

Заключение

В этой статье мы узнали, как преобразовать JPG в PDF-документ в облаке. Мы также увидели, как конвертировать JPG в PDF и добавлять водяные знаки в преобразованные документы с помощью Python. В этой статье также объясняется, как программно загрузить файл изображения JPG в облако, а затем загрузить преобразованный файл PDF из облака. Кроме того, вы можете узнать больше о GroupDocs.Conversion Cloud API, воспользовавшись документацией. Мы также предоставляем раздел Справочник по API, который позволяет визуализировать наши API и взаимодействовать с ними непосредственно через браузер. В случае возникновения каких-либо неясностей, пожалуйста, свяжитесь с нами на форуме.

Смотрите также