Převeďte obrázky do PDF pomocí REST API v Pythonu

PDF je jedním z oblíbených formátů pro sdílení a tisk dokumentů. Často potřebujeme převádět dokumenty různých formátů a obrázků do PDF. Vývoj takových nástrojů vyžaduje spoustu času a úsilí. Je tedy lepší používat již vyvinuté specializované nástroje, které poskytují snadno udržovatelné a flexibilní řešení vašich potřeb. Za tímto účelem REST API pro konverzi obrázků do PDF a Python SDK umožňují převádět dokumenty podporovaných formátů do PDF programově v cloudu. V tomto článku se naučíme, jak převést obrázky do PDF pomocí REST API v Pythonu.

Tento článek bude obsahovat následující témata:

Převod obrázku do PDF REST API a Python SDK

Pro převod JPG nebo PNG obrázků do PDF budeme používat Python SDK of GroupDocs.Conversion Cloud API. Nainstalujte jej pomocí následujícího příkazu v konzole:

pip install groupdocs_converison_cloud

Před provedením uvedených kroků získejte své ID klienta a tajný klíč z řídicího panelu. Jakmile budete mít své ID a tajemství, přidejte kód, jak je uvedeno níže:

# Tento příklad kódu ukazuje, jak nastavit ID klienta a tajný klíč.
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 = ""

Převeďte JPG do PDF pomocí REST API v Pythonu

Obrázky můžeme převést na dokumenty PDF pomocí následujících jednoduchých kroků:

  1. Nahrát soubor obrázku JPG do cloudu
  2. Převést JPG do PDF pomocí Pythonu
  3. Stáhnout převedený soubor PDF

Nahrajte obrázek

Nejprve nahrajeme soubor obrázku JPG do cloudu pomocí následující ukázky kódu:

# Tento příklad kódu ukazuje, jak nahrát soubor obrázku JPG do cloudu.
# Vytvořte instanci rozhraní API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# žádost o nahrání souboru
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)

# nahrát ukázkový soubor
response = file_api.upload_file(request)

V důsledku toho bude nahraný soubor dostupný v sekce souborů řídicího panelu v cloudu.

Převeďte JPG do PDF pomocí Pythonu

Obrázky JPG můžeme převést na dokumenty PDF programově podle následujících kroků:

  • Nejprve vytvořte instanci ConvertApi.
  • Dále vytvořte instanci ConvertSettings.
  • Poté nastavte cestu k souboru JPG.
  • A přiřaďte formátu „pdf“.
  • Uveďte také cestu k výstupnímu souboru.
  • Poté vytvořte ConvertDocumentRequest s ConvertSettings jako argumentem.
  • Nakonec zavolejte metodu ConvertApi.convert\document() pomocí ConvertDocumentRequest a uložte převedený soubor.

Následující ukázka kódu ukazuje, jak převést obrázek JPG na dokument PDF pomocí REST API v Pythonu.

# Tento příklad kódu ukazuje, jak převést JPT do PDF.
# Vytvořte potřebné instance API
konvertovat_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Připravte nastavení převodu
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "konvertovated"

# Převést požadavek
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# konvertovat
result = konvertovat_api.konvertovat_document(request)

# Hotovo
print("Document konvertovated: " + result[0].path)
Převeďte JPG do PDF pomocí REST API v Pythonu.

Převeďte JPG do PDF pomocí REST API v Pythonu.

Stáhněte si převedené PDF

Výše uvedená ukázka kódu uloží převedený dokument PDF do cloudu. Lze jej stáhnout pomocí následujícího příkladu kódu:

# Tento příklad kódu ukazuje, jak stáhnout soubor PDF z cloudu.
# Inicializace API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# Žádost o stažení souboru
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# Stáhnout soubor
response = file_api.download_file(request)

# Přesuňte stažený soubor do svého pracovního adresáře
shutil.move(response, "C:\\Files\\Conversion\\")

Převod JPG do PDF s pokročilými možnostmi

Můžeme převést JPG na PDF dokument s některými pokročilými nastaveními programově podle následujících kroků:

  • Nejprve vytvořte instanci ConvertApi.
  • Dále vytvořte instanci ConvertSettings.
  • Poté nastavte cestu k souboru JPG.
  • A přiřaďte formátu „pdf“.
  • Uveďte také cestu k výstupnímu souboru.
  • Dále vytvořte instanci PdfConvertOptions a přiřaďte ji k ConvertSettings.
  • Poté nastavte různá nastavení převodu, jako je dpi, stupně šedi, obrázek\kvalita, výška, okraje (nahoře, vlevo, vpravo, dole) atd.
  • Poté vytvořte ConvertDocumentRequest s ConvertSettings jako argumentem.
  • Nakonec zavolejte metodu ConvertApi.convert\document() pomocí ConvertDocumentRequest a uložte převedený soubor.

Následující příklad kódu ukazuje, jak převést obrázek JPG na dokument PDF s pokročilými možnostmi převodu. Chcete-li nahrát soubor obrázku JPG a stáhnout převedený soubor PDF, postupujte podle výše uvedených kroků.

# Tento příklad kódu ukazuje, jak převést JPT do PDF s rozšířenými možnostmi.
# Vytvořte potřebné instance API
konvertovat_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Připravte nastavení převodu
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "konvertovated_with_options.pdf"

# Možnosti převodu PDF
konvertovatOptions = groupdocs_conversion_cloud.PdfConvertOptions()
konvertovatOptions.center_window = True
konvertovatOptions.display_doc_title = True
konvertovatOptions.dpi = 1024.0
konvertovatOptions.fit_window = False
konvertovatOptions.grayscale = True
konvertovatOptions.image_quality = 100
konvertovatOptions.linearize = True
konvertovatOptions.margin_top = 500
konvertovatOptions.margin_left = 500
konvertovatOptions.margin_right = 500
konvertovatOptions.margin_bottom = 500

settings.konvertovat_options = konvertovatOptions

# Převést požadavek
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# konvertovat
result = konvertovat_api.konvertovat_document(request)

# Hotovo
print("Document konvertovated: " + result[0].path)
Převod JPG do PDF s pokročilými možnostmi.

Převod JPG do PDF s pokročilými možnostmi.

Převeďte JPG do PDF s vodoznakem v Pythonu

Můžeme převést JPG na dokument PDF a poté přidat vodoznak do převedeného PDF programově podle následujících kroků:

  • Nejprve vytvořte instanci ConvertApi.
  • Dále vytvořte instanci ConvertSettings.
  • Poté nastavte cestu k souboru JPG, přiřaďte formát „pdf“ a zadejte cestu k výstupnímu souboru.
  • Dále vytvořte instanci WatermarkOptions.
  • Poté nastavte text vodoznaku, barvu, písmo\velikost, otočení\úhel atd.
  • Dále vytvořte instanci PdfConvertOptions a přiřaďte ji k WatermarkOptions.
  • Poté volitelně nastavte různá nastavení převodu.
  • A přiřaďte PdfConvertOptions k ConvertSettings.
  • Poté vytvořte ConvertDocumentRequest s ConvertSettings jako argumentem.
  • Nakonec zavolejte metodu ConvertApi.convert\document() pomocí ConvertDocumentRequest a uložte převedený soubor.

Následující příklad kódu ukazuje, jak převést JPG na dokument PDF a přidat vodoznak do převedeného dokumentu PDF pomocí REST API v Pythonu.

# Tento příklad kódu ukazuje, jak převést JPT do PDF a přidat vodoznak do převedeného PDF.
# Inicializace API
convert_api = groupdocs_conversion_cloud.KonvertovatApi.from_keys(client_id, client_secret)

# Definujte nastavení převodu
settings = groupdocs_conversion_cloud.KonvertovatSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"

# Definujte možnosti vodoznaku
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;

# Definujte možnosti převodu PDF
convertOptions = groupdocs_conversion_cloud.PdfKonvertovatOptions()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# Vytvořit žádost o převod dokumentu
request = groupdocs_conversion_cloud.KonvertovatDocumentRequest(settings)
# Konvertovat
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
Převeďte JPG do PDF s vodoznakem v Pythonu.

Převeďte JPG do PDF s vodoznakem v Pythonu.

Převést JPG do PDF a stáhnout soubor přímo

Můžeme převést JPG do PDF programově a stáhnout převedený soubor PDF přímo podle následujících kroků:

  • Nejprve vytvořte instanci ConvertApi.
  • Dále vytvořte instanci ConvertSettings.
  • Poté nastavte cestu k souboru JPG.
  • A přiřaďte formátu „pdf“.
  • Zadejte také cestu k výstupnímu souboru jako Žádná.
  • Poté vytvořte ConvertDocumentRequest s ConvertSettings jako argumentem.
  • Nakonec zavolejte metodu ConvertApi.convert\document\download() pomocí ConvertDocumentRequest a uložte převedený soubor na místní disk.

Následující ukázka kódu ukazuje, jak převést soubor obrázku JPG na dokument PDF a stáhnout jej přímo pomocí REST API v Pythonu. API jako odpověď vrátí převedený soubor PDF. Chcete-li nahrát soubor, postupujte podle výše uvedených kroků.

# Tento příklad kódu ukazuje, jak překrýt a stáhnout.
# Vytvořte potřebné instance API
convert_api = groupdocs_conversion_cloud.KonvertovatApi.from_keys(client_id, client_secret)

# Připravte nastavení převodu
settings = groupdocs_conversion_cloud.KonvertovatSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"

settings.output_path = None    # leave OutputPath will result the output as document IOStream

# Připravte žádost
request = groupdocs_conversion_cloud.KonvertovatDocumentRequest(settings)

# Konvertovat
response = convert_api.convert_document_download(request)

# Přesuňte stažený soubor do svého pracovního adresáře
shutil.move(response, "C:\\Files\\Conversion\\")

Převod JPG do PDF bez použití cloudového úložiště

JPG můžeme převést na PDF bez použití cloudového úložiště podle následujících kroků:

  • Nejprve vytvořte instanci ConvertApi
  • Dále vytvořte ConvertDocumentDirectRequest s cílovým formátem a vstupní cestou k souboru obrázku jako argumenty.
  • Poté zavolejte metodu convert\document\direct() s argumentem ConvertDocumentDirectRequest.
  • Nakonec uložte převedený výstupní soubor PDF do místní cesty pomocí metody FileStream.writeFile().

Následující ukázka kódu ukazuje, jak převést JPG na dokument PDF bez použití cloudového úložiště. To znamená, že předáme vstupní soubor v těle požadavku a výstupní soubor obdržíme v odpovědi API.

# Tento příklad kódu ukazuje, jak převést JPT do PDF bez použití cloudového úložiště.
# Vytvořte potřebné instance API
convert_api = groupdocs_conversion_cloud.KonvertovatApi.from_keys(client_id, client_secret)

# Připravte žádost
request = groupdocs_conversion_cloud.KonvertovatDocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")

# Konvertovat
result = convert_api.convert_document_direct(request)

# Přesuňte stažený soubor do svého pracovního adresáře
shutil.move(result, "C:\\Files\\Conversion\\")

Vyzkoušejte online

Vyzkoušejte prosím následující bezplatný online nástroj pro převod JPG, který je vyvinut pomocí výše uvedeného API. https://products.groupdocs.app/conversion/

Závěr

V tomto článku jsme se naučili, jak převést JPG na dokument PDF v cloudu. Také jsme viděli, jak převést JPG do PDF a přidat vodoznak do převedených dokumentů pomocí Pythonu. Tento článek také vysvětluje, jak programově nahrát soubor obrázku JPG do cloudu a poté stáhnout převedený soubor PDF z cloudu. Kromě toho se můžete dozvědět více o GroupDocs.Conversion Cloud API pomocí dokumentace. Poskytujeme také sekci API Reference, která vám umožní vizualizovat a pracovat s našimi API přímo prostřednictvím prohlížeče. V případě jakýchkoliv nejasností nás neváhejte kontaktovat na fóru.

Viz také