Перетворюйте зображення у PDF за допомогою REST API у Python

PDF є одним із популярних форматів для спільного використання та друку документів. Нам часто потрібно конвертувати документи різних форматів і зображення в PDF. Розробка таких інструментів потребує багато часу та зусиль. Отже, краще використовувати вже розроблені спеціалізовані інструменти, які забезпечують легке обслуговування, гнучке рішення для ваших потреб. Для цього REST API для перетворення зображень у PDF і Python SDK дозволяють конвертувати документи підтримуваних форматів у PDF програмним шляхом у хмарі. У цій статті ми дізнаємося, як конвертувати зображення у PDF за допомогою REST API у Python.

У цій статті будуть розглянуті такі теми:

REST API перетворення зображень у PDF і Python SDK

Для перетворення зображень JPG або PNG у PDF ми будемо використовувати Python SDK 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 за допомогою API REST у 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.
  • Потім установіть різні параметри перетворення, такі як роздільна здатність, градації сірого, зображення\якість, висота, поля (верхнє, ліве, праве, нижнє) тощо.
  • Після цього створіть 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» формату.
  • Також укажіть шлях до вихідного файлу як «Немає».
  • Після цього створіть ConvertDocumentRequest з ConvertSettings як аргумент.
  • Нарешті, викличте метод ConvertApi.convert\document\download() за допомогою ConvertDocumentRequest, щоб зберегти перетворений файл на локальному диску.

У наведеному нижче прикладі коду показано, як перетворити файл зображення JPG на документ PDF і завантажити його безпосередньо за допомогою API REST у 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 Reference, який дозволяє візуалізувати наші API та взаємодіяти з ними безпосередньо через браузер. У разі будь-яких неясностей зв’яжіться з нами на форумі.

Дивись також