Converti immagini in PDF utilizzando l'API REST in Python

PDF è uno dei formati più diffusi per la condivisione e la stampa di documenti. Spesso abbiamo bisogno di convertire documenti di diversi formati e immagini in PDF. Richiede molto tempo e impegno per sviluppare tali strumenti. Pertanto, è meglio utilizzare strumenti specializzati già sviluppati che forniscono una soluzione flessibile e di facile manutenzione per le tue esigenze. A tale scopo, l’API REST per la conversione da immagine a PDF e l’SDK Python consentono di convertire documenti di formati supportati in PDF in modo programmatico sul cloud. In questo articolo impareremo come convertire le immagini in PDF utilizzando un’API REST in Python.

In questo articolo saranno trattati i seguenti argomenti:

Conversione da immagine a PDF REST API e Python SDK

Per convertire le immagini JPG o PNG in PDF, utilizzeremo l’API Python SDK of GroupDocs.Conversion Cloud. Si prega di installarlo utilizzando il seguente comando nella console:

pip install groupdocs_converison_cloud

Si prega di ottenere l’ID cliente e il segreto dalla dashboard prima di seguire i passaggi menzionati. Una volta che hai il tuo ID e segreto, aggiungi il codice come mostrato di seguito:

# Questo esempio di codice mostra come impostare l'ID client e il segreto.
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 = ""

Converti JPG in PDF utilizzando un’API REST in Python

Possiamo convertire le immagini in documenti PDF seguendo i semplici passaggi indicati di seguito:

  1. Carica il file immagine JPG nel Cloud
  2. Converti JPG in PDF usando Python
  3. Scarica il file PDF convertito

Carica l’immagine

Innanzitutto, caricheremo il file immagine JPG nel cloud utilizzando il seguente esempio di codice:

# Questo esempio di codice mostra come caricare un file immagine JPG nel cloud.
# Crea un'istanza dell'API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# richiesta di caricamento del file
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)

# caricare file di esempio
response = file_api.upload_file(request)

Di conseguenza, il file caricato sarà disponibile nella sezione file della dashboard sul cloud.

Converti JPG in PDF usando Python

Possiamo convertire le immagini JPG in documenti PDF in modo programmatico seguendo i passaggi indicati di seguito:

  • Innanzitutto, crea un’istanza di ConvertApi.
  • Successivamente, crea un’istanza di ConvertSettings.
  • Quindi, imposta il percorso del file JPG.
  • E assegna “pdf” al formato.
  • Inoltre, fornire il percorso del file di output.
  • Successivamente, crea ConvertDocumentRequest con ConvertSettings come argomento.
  • Infine, chiama il metodo ConvertApi.convert\document() con ConvertDocumentRequest per salvare il file convertito.

L’esempio di codice seguente mostra come convertire un’immagine JPG in un documento PDF usando un’API REST in Python.

# Questo esempio di codice mostra come convertireire JPT in PDF.
# Crea le istanze API necessarie
convertire_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Preparare le impostazioni di conversione
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "convertireed"

# Converti richiesta
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# convertire
result = convertire_api.convertire_document(request)

# Fatto
print("Document convertireed: " + result[0].path)
Converti JPG in PDF utilizzando un'API REST in Python.

Converti JPG in PDF utilizzando un’API REST in Python.

Scarica il PDF convertito

L’esempio di codice precedente salverà il documento PDF convertito sul cloud. Può essere scaricato utilizzando il seguente esempio di codice:

# Questo esempio di codice mostra come scaricare file PDF dal cloud.
# Inizializzazione dell'API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# Scarica la richiesta di file
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# Download file
response = file_api.download_file(request)

# Sposta il file scaricato nella tua directory di lavoro
shutil.move(response, "C:\\Files\\Conversion\\")

Conversione da JPG a PDF con opzioni avanzate

Possiamo convertire un documento JPG in PDF con alcune impostazioni avanzate a livello di codice seguendo i passaggi indicati di seguito:

  • Innanzitutto, crea un’istanza di ConvertApi.
  • Successivamente, crea un’istanza di ConvertSettings.
  • Quindi, imposta il percorso del file JPG.
  • E assegna “pdf” al formato.
  • Inoltre, fornire il percorso del file di output.
  • Quindi, crea un’istanza di PdfConvertOptions e assegna a ConvertSettings.
  • Quindi, imposta varie impostazioni di conversione come dpi, scala di grigi, immagine\qualità, altezza, margini (superiore, sinistro, destro, inferiore), ecc.
  • Successivamente, crea ConvertDocumentRequest con ConvertSettings come argomento.
  • Infine, chiama il metodo ConvertApi.convert\document() con ConvertDocumentRequest per salvare il file convertito.

L’esempio di codice seguente mostra come convertire un’immagine JPG in un documento PDF con opzioni di conversione avanzate. Si prega di seguire i passaggi menzionati in precedenza per caricare un file immagine JPG e scaricare il file PDF convertito.

# Questo esempio di codice mostra come convertireire JPT in PDF con le opzioni avanzate.
# Crea le istanze API necessarie
convertire_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Preparare le impostazioni di conversione
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "convertireed_with_options.pdf"

# Opzioni di conversione PDF
convertireOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertireOptions.center_window = True
convertireOptions.display_doc_title = True
convertireOptions.dpi = 1024.0
convertireOptions.fit_window = False
convertireOptions.grayscale = True
convertireOptions.image_quality = 100
convertireOptions.linearize = True
convertireOptions.margin_top = 500
convertireOptions.margin_left = 500
convertireOptions.margin_right = 500
convertireOptions.margin_bottom = 500

settings.convertire_options = convertireOptions

# Converti richiesta
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# convertire
result = convertire_api.convertire_document(request)

# Fatto
print("Document convertireed: " + result[0].path)
Conversione da JPG a PDF con opzioni avanzate.

Conversione da JPG a PDF con opzioni avanzate.

Converti JPG in PDF con Watermark in Python

Possiamo convertire JPG in documento PDF e quindi aggiungere la filigrana al PDF convertito in modo programmatico seguendo i passaggi indicati di seguito:

  • Innanzitutto, crea un’istanza di ConvertApi.
  • Successivamente, crea un’istanza di ConvertSettings.
  • Quindi, imposta il percorso del file JPG, assegna “pdf” al formato e fornisci il percorso del file di output.
  • Successivamente, crea un’istanza di WatermarkOptions.
  • Quindi, imposta il testo della filigrana, il colore, il carattere\dimensione, la rotazione\l’angolo, ecc.
  • Successivamente, crea un’istanza di PdfConvertOptions e assegnala a WatermarkOptions.
  • Quindi, facoltativamente, imposta varie impostazioni di conversione.
  • E, assegna PdfConvertOptions a ConvertSettings.
  • Successivamente, crea ConvertDocumentRequest con ConvertSettings come argomento.
  • Infine, chiama il metodo ConvertApi.convert\document() con ConvertDocumentRequest per salvare il file convertito.

L’esempio di codice seguente mostra come convertire JPG in un documento PDF e aggiungere una filigrana al documento PDF convertito utilizzando un’API REST in Python.

# Questo esempio di codice mostra come convertire JPT in PDF e aggiungere filigrana al PDF convertito.
# Inizializzazione dell'API
convert_api = groupdocs_conversion_cloud.ConvertireApi.from_keys(client_id, client_secret)

# Definire le impostazioni di conversione
settings = groupdocs_conversion_cloud.ConvertireSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"

# Definire le opzioni della filigrana
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;

# Definisci le opzioni di conversione PDF
convertOptions = groupdocs_conversion_cloud.PdfConvertireOptions()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# Crea una richiesta di conversione del documento
request = groupdocs_conversion_cloud.ConvertireDocumentRequest(settings)
# Convertire
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
Converti JPG in PDF con Watermark in Python.

Converti JPG in PDF con Watermark in Python.

Converti JPG in PDF e scarica il file direttamente

Possiamo convertire JPG in PDF in modo programmatico e scaricare direttamente il file PDF convertito seguendo i passaggi indicati di seguito:

  • Innanzitutto, crea un’istanza di ConvertApi.
  • Successivamente, crea un’istanza di ConvertSettings.
  • Quindi, imposta il percorso del file JPG.
  • E assegna “pdf” al formato.
  • Inoltre, fornire il percorso del file di output come Nessuno.
  • Successivamente, crea ConvertDocumentRequest con ConvertSettings come argomento.
  • Infine, chiama il metodo ConvertApi.convert\document\download() con ConvertDocumentRequest per salvare il file convertito sul disco locale.

L’esempio di codice seguente mostra come convertire un file immagine JPG in un documento PDF e scaricarlo direttamente usando un’API REST in Python. L’API restituirà il file PDF convertito in risposta. Si prega di seguire i passaggi menzionati in precedenza per caricare un file.

# Questo esempio di codice mostra come convertire e scaricare.
# Crea le istanze API necessarie
convert_api = groupdocs_conversion_cloud.ConvertireApi.from_keys(client_id, client_secret)

# Preparare le impostazioni di conversione
settings = groupdocs_conversion_cloud.ConvertireSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"

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

# Prepara la richiesta
request = groupdocs_conversion_cloud.ConvertireDocumentRequest(settings)

# Convertire
response = convert_api.convert_document_download(request)

# Sposta il file scaricato nella tua directory di lavoro
shutil.move(response, "C:\\Files\\Conversion\\")

Conversione da JPG a PDF senza utilizzare Cloud Storage

Possiamo convertire JPG in PDF senza utilizzare il cloud storage seguendo i passaggi indicati di seguito:

  • Innanzitutto, crea un’istanza di ConvertApi
  • Successivamente, crea ConvertDocumentDirectRequest con il formato di destinazione e il percorso del file immagine di input come argomenti.
  • Quindi, chiama il metodo convert\document\direct() con ConvertDocumentDirectRequest come argomento.
  • Infine, salva il file PDF di output convertito nel percorso locale utilizzando il metodo FileStream.writeFile().

L’esempio di codice seguente mostra come convertire JPG in un documento PDF senza utilizzare l’archiviazione cloud. Significa che passeremo il file di input nel corpo della richiesta e riceveremo il file di output nella risposta dell’API.

# Questo esempio di codice mostra come convertire JPT in PDF senza utilizzare l'archiviazione cloud.
# Crea le istanze API necessarie
convert_api = groupdocs_conversion_cloud.ConvertireApi.from_keys(client_id, client_secret)

# Prepara la richiesta
request = groupdocs_conversion_cloud.ConvertireDocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")

# Convertire
result = convert_api.convert_document_direct(request)

# Sposta il file scaricato nella tua directory di lavoro
shutil.move(result, "C:\\Files\\Conversion\\")

Prova in linea

Prova il seguente strumento di conversione JPG online gratuito, sviluppato utilizzando l’API di cui sopra. https://products.groupdocs.app/conversion/

Conclusione

In questo articolo, abbiamo imparato come convertire un documento JPG in un documento PDF sul cloud. Abbiamo anche visto come convertire JPG in PDF e aggiungere watermark ai documenti convertiti usando Python. Questo articolo ha anche spiegato come caricare in modo programmatico un file immagine JPG nel cloud e quindi scaricare il file PDF convertito dal cloud. Inoltre, puoi saperne di più su GroupDocs.Conversion Cloud API utilizzando la documentazione. Forniamo anche una sezione Riferimento API che ti consente di visualizzare e interagire con le nostre API direttamente attraverso il browser. In caso di ambiguità, non esitate a contattarci sul forum.

Guarda anche