Convertir des images en PDF à l'aide de l'API REST en Python

PDF est l’un des formats populaires pour le partage et l’impression de documents. Nous avons souvent besoin de convertir des documents de différents formats et images en PDF. Il faut beaucoup de temps et d’efforts pour développer de tels outils. Il est donc préférable d’utiliser des outils spécialisés déjà développés qui offrent une solution facilement maintenable et flexible à vos besoins. À cette fin, l’API REST de conversion d’image en PDF et le SDK Python permettent de convertir des documents de formats pris en charge en PDF par programme sur le cloud. Dans cet article, nous allons apprendre à convertir des images en PDF à l’aide d’une API REST en Python.

Les sujets suivants seront traités dans cet article :

API REST de conversion d’image en PDF et SDK Python

Pour convertir des images JPG ou PNG en PDF, nous utiliserons l’API Python SDK of GroupDocs.Conversion Cloud. Veuillez l’installer à l’aide de la commande suivante dans la console :

pip install groupdocs_converison_cloud

Veuillez obtenir votre ID client et votre secret à partir du tableau de bord avant de suivre les étapes mentionnées. Une fois que vous avez votre identifiant et votre secret, ajoutez le code comme indiqué ci-dessous :

# Cet exemple de code montre comment définir l'ID client et le secret.
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 = ""

Convertir JPG en PDF à l’aide d’une API REST en Python

Nous pouvons convertir des images en documents PDF en suivant les étapes simples indiquées ci-dessous :

  1. Téléchargez le fichier image JPG sur le Cloud
  2. Convertir JPG en PDF en utilisant Python
  3. Télécharger le fichier PDF converti

Télécharger l’image

Tout d’abord, nous allons télécharger le fichier image JPG dans le cloud à l’aide de l’exemple de code suivant :

# Cet exemple de code montre comment télécharger un fichier image JPG dans le Cloud.
# Créer une instance de l'API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# demande de téléchargement de fichier
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)

# télécharger un exemple de fichier
response = file_api.upload_file(request)

Par conséquent, le fichier téléchargé sera disponible dans la section fichiers du tableau de bord sur le cloud.

Convertir JPG en PDF en utilisant Python

Nous pouvons convertir des images JPG en documents PDF par programmation en suivant les étapes ci-dessous :

  • Tout d’abord, créez une instance de ConvertApi.
  • Ensuite, créez une instance de ConvertSettings.
  • Ensuite, définissez le chemin du fichier JPG.
  • Et, attribuez “pdf” au format.
  • Indiquez également le chemin du fichier de sortie.
  • Après cela, créez ConvertDocumentRequest avec ConvertSettings comme argument.
  • Enfin, appelez la méthode ConvertApi.convert\document() avec ConvertDocumentRequest pour enregistrer le fichier converti.

L’exemple de code suivant montre comment convertir une image JPG en document PDF à l’aide d’une API REST en Python.

# Cet exemple de code montre comment convertirir JPT en PDF.
# Créer les instances d'API nécessaires
convertir_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Préparer les paramètres de conversion
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "convertired"

# Convertir la demande
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# convertir
result = convertir_api.convertir_document(request)

# Fait
print("Document convertired: " + result[0].path)
Convertissez JPG en PDF à l'aide d'une API REST en Python.

Convertissez JPG en PDF à l’aide d’une API REST en Python.

Télécharger le PDF converti

L’exemple de code ci-dessus enregistrera le document PDF converti sur le cloud. Il peut être téléchargé à l’aide de l’exemple de code suivant :

# Cet exemple de code montre comment télécharger un fichier PDF à partir du Cloud.
# Initialisation de l'API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# Télécharger la demande de fichier
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# Télécharger un fichier
response = file_api.download_file(request)

# Déplacez le fichier téléchargé dans votre répertoire de travail
shutil.move(response, "C:\\Files\\Conversion\\")

Conversion JPG en PDF avec options avancées

Nous pouvons convertir JPG en document PDF avec certains paramètres avancés par programmation en suivant les étapes ci-dessous :

  • Tout d’abord, créez une instance de ConvertApi.
  • Ensuite, créez une instance de ConvertSettings.
  • Ensuite, définissez le chemin du fichier JPG.
  • Et, attribuez “pdf” au format.
  • Indiquez également le chemin du fichier de sortie.
  • Ensuite, créez une instance de PdfConvertOptions et attribuez-la à ConvertSettings.
  • Ensuite, définissez divers paramètres de conversion tels que ppp, niveaux de gris, image\qualité, hauteur, marges (haut, gauche, droite, bas), etc.
  • Après cela, créez ConvertDocumentRequest avec ConvertSettings comme argument.
  • Enfin, appelez la méthode ConvertApi.convert\document() avec ConvertDocumentRequest pour enregistrer le fichier converti.

L’exemple de code suivant montre comment convertir une image JPG en un document PDF avec des options de conversion avancées. Veuillez suivre les étapes mentionnées précédemment pour télécharger un fichier image JPG et télécharger le fichier PDF converti.

# Cet exemple de code montre comment convertirir JPT en PDF avec les options avancées.
# Créer les instances d'API nécessaires
convertir_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Préparer les paramètres de conversion
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "convertired_with_options.pdf"

# Options de conversion PDF
convertirOptions = groupdocs_conversion_cloud.PdfConvertOptions()
convertirOptions.center_window = True
convertirOptions.display_doc_title = True
convertirOptions.dpi = 1024.0
convertirOptions.fit_window = False
convertirOptions.grayscale = True
convertirOptions.image_quality = 100
convertirOptions.linearize = True
convertirOptions.margin_top = 500
convertirOptions.margin_left = 500
convertirOptions.margin_right = 500
convertirOptions.margin_bottom = 500

settings.convertir_options = convertirOptions

# Convertir la demande
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# convertir
result = convertir_api.convertir_document(request)

# Fait
print("Document convertired: " + result[0].path)
Conversion JPG en PDF avec options avancées.

Conversion JPG en PDF avec options avancées.

Convertir JPG en PDF avec filigrane en Python

Nous pouvons convertir JPG en document PDF, puis ajouter un filigrane au PDF converti par programmation en suivant les étapes ci-dessous :

  • Tout d’abord, créez une instance de ConvertApi.
  • Ensuite, créez une instance de ConvertSettings.
  • Ensuite, définissez le chemin du fichier JPG, attribuez “pdf” au format et fournissez le chemin du fichier de sortie.
  • Ensuite, créez une instance de WatermarkOptions.
  • Ensuite, définissez le texte du filigrane, la couleur, la police\taille, la rotation\angle, etc.
  • Ensuite, créez une instance de PdfConvertOptions et attribuez-la à WatermarkOptions.
  • Ensuite, définissez éventuellement divers paramètres de conversion.
  • Et, affectez PdfConvertOptions à ConvertSettings.
  • Après cela, créez ConvertDocumentRequest avec ConvertSettings comme argument.
  • Enfin, appelez la méthode ConvertApi.convert\document() avec ConvertDocumentRequest pour enregistrer le fichier converti.

L’exemple de code suivant montre comment convertir JPG en document PDF et ajouter un filigrane au document PDF converti à l’aide d’une API REST en Python.

# Cet exemple de code montre comment convertir JPT en PDF et ajouter un filigrane au PDF converti.
# Initialisation de l'API
convert_api = groupdocs_conversion_cloud.ConvertirApi.from_keys(client_id, client_secret)

# Définir les paramètres de conversion
settings = groupdocs_conversion_cloud.ConvertirSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"

# Définir les options de filigrane
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;

# Définir les options de conversion PDF
convertOptions = groupdocs_conversion_cloud.PdfConvertirOptions()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# Créer une demande de conversion de document
request = groupdocs_conversion_cloud.ConvertirDocumentRequest(settings)
# Convertir
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
Convertir JPG en PDF avec filigrane en Python.

Convertir JPG en PDF avec filigrane en Python.

Convertir JPG en PDF et télécharger le fichier directement

Nous pouvons convertir JPG en PDF par programme et télécharger directement le fichier PDF converti en suivant les étapes ci-dessous :

  • Tout d’abord, créez une instance de ConvertApi.
  • Ensuite, créez une instance de ConvertSettings.
  • Ensuite, définissez le chemin du fichier JPG.
  • Et, attribuez “pdf” au format.
  • Indiquez également le chemin du fichier de sortie sur Aucun.
  • Après cela, créez ConvertDocumentRequest avec ConvertSettings comme argument.
  • Enfin, appelez la méthode ConvertApi.convert\document\download() avec ConvertDocumentRequest pour enregistrer le fichier converti sur le disque local.

L’exemple de code suivant montre comment convertir un fichier image JPG en document PDF et le télécharger directement à l’aide d’une API REST en Python. L’API doit renvoyer le fichier PDF converti en réponse. Veuillez suivre les étapes mentionnées précédemment pour télécharger un fichier.

# Cet exemple de code montre comment convertir et télécharger.
# Créer les instances d'API nécessaires
convert_api = groupdocs_conversion_cloud.ConvertirApi.from_keys(client_id, client_secret)

# Préparer les paramètres de conversion
settings = groupdocs_conversion_cloud.ConvertirSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"

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

# Préparer la demande
request = groupdocs_conversion_cloud.ConvertirDocumentRequest(settings)

# Convertir
response = convert_api.convert_document_download(request)

# Déplacez le fichier téléchargé dans votre répertoire de travail
shutil.move(response, "C:\\Files\\Conversion\\")

Conversion JPG en PDF sans utiliser Cloud Storage

Nous pouvons convertir JPG en PDF sans utiliser le stockage en nuage en suivant les étapes ci-dessous :

  • Tout d’abord, créez une instance de ConvertApi
  • Ensuite, créez ConvertDocumentDirectRequest avec le format cible et le chemin du fichier image d’entrée comme arguments.
  • Ensuite, appelez la méthode convert\document\direct() avec ConvertDocumentDirectRequest comme argument.
  • Enfin, enregistrez le fichier PDF de sortie converti dans le chemin local à l’aide de la méthode FileStream.writeFile().

L’exemple de code suivant montre comment convertir un fichier JPG en un document PDF sans utiliser le stockage dans le cloud. Cela signifie que nous transmettrons le fichier d’entrée dans le corps de la requête et recevrons le fichier de sortie dans la réponse de l’API.

# Cet exemple de code montre comment convertir JPT en PDF sans utiliser le stockage Cloud.
# Créer les instances d'API nécessaires
convert_api = groupdocs_conversion_cloud.ConvertirApi.from_keys(client_id, client_secret)

# Préparer la demande
request = groupdocs_conversion_cloud.ConvertirDocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")

# Convertir
result = convert_api.convert_document_direct(request)

# Déplacez le fichier téléchargé dans votre répertoire de travail
shutil.move(result, "C:\\Files\\Conversion\\")

Essayez en ligne

Veuillez essayer l’outil de conversion JPG en ligne gratuit suivant, qui est développé à l’aide de l’API ci-dessus. https://products.groupdocs.app/conversion/

Conclusion

Dans cet article, nous avons appris comment convertir un JPG en un document PDF sur le cloud. Nous avons également vu comment convertir JPG en PDF et ajouter un filigrane aux documents convertis à l’aide de Python. Cet article a également expliqué comment télécharger par programmation un fichier image JPG dans le cloud, puis télécharger le fichier PDF converti à partir du cloud. En outre, vous pouvez en savoir plus sur l’API GroupDocs.Conversion Cloud à l’aide de la documentation. Nous fournissons également une section API Reference qui vous permet de visualiser et d’interagir avec nos API directement via le navigateur. En cas d’ambiguïté, n’hésitez pas à nous contacter sur le forum.

Voir également