Convierta imágenes a PDF usando REST API en Python

PDF es uno de los formatos populares para compartir e imprimir documentos. A menudo necesitamos convertir documentos de diferentes formatos e imágenes a PDF. Se requiere mucho tiempo y esfuerzo para desarrollar dichas herramientas. Por lo tanto, es mejor utilizar herramientas especializadas ya desarrolladas que proporcionen una solución flexible y de fácil mantenimiento para sus necesidades. Para este propósito, la API REST de conversión de imagen a PDF y el SDK de Python permiten convertir documentos de formatos admitidos a PDF mediante programación en la nube. En este artículo, aprenderemos cómo convertir imágenes a PDF utilizando una API REST en Python.

En este artículo se tratarán los siguientes temas:

API REST de conversión de imagen a PDF y SDK de Python

Para convertir imágenes JPG o PNG a PDF, usaremos la API Python SDK de GroupDocs.Conversion Cloud. Instálalo usando el siguiente comando en la consola:

pip install groupdocs_converison_cloud

Por favor, obtenga su ID de cliente y secreto del tablero antes de seguir los pasos mencionados. Una vez que tenga su ID y secreto, agregue el código como se muestra a continuación:

# Este ejemplo de código demuestra cómo configurar el ID y el secreto del cliente.
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 = ""

Convierta JPG a PDF usando una API REST en Python

Podemos convertir imágenes a documentos PDF siguiendo los sencillos pasos que se detallan a continuación:

  1. Subir el archivo de imagen JPG a la nube
  2. Convertir JPG a PDF usando Python
  3. Descargar el archivo PDF convertido

Sube la imagen

En primer lugar, subiremos el archivo de imagen JPG a la nube usando el siguiente código de ejemplo:

# Este ejemplo de código demuestra cómo cargar un archivo de imagen JPG en la nube.
# Crear instancia de la API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# cargar solicitud de archivo
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)

# cargar archivo de muestra
response = file_api.upload_file(request)

Como resultado, el archivo cargado estará disponible en la sección de archivos del tablero en la nube.

Convierte JPG a PDF usando Python

Podemos convertir imágenes JPG a documentos PDF mediante programación siguiendo los pasos que se detallan a continuación:

  • En primer lugar, cree una instancia de ConvertApi.
  • A continuación, cree una instancia de ConvertSettings.
  • Luego, configure la ruta del archivo JPG.
  • Y asigne “pdf” al formato.
  • Además, proporcione la ruta del archivo de salida.
  • Después de eso, cree ConvertDocumentRequest con ConvertSettings como argumento.
  • Finalmente, llame al método ConvertApi.convert\document() con ConvertDocumentRequest para guardar el archivo convertido.

El siguiente ejemplo de código muestra cómo convertir una imagen JPG en un documento PDF mediante una API REST en Python.

# Este ejemplo de código demuestra cómo convertirir JPT a PDF.
# Crear las instancias de API necesarias
convertir_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Preparar la configuración de conversión
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "convertired"

# Convertir solicitud
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# convertir
result = convertir_api.convertir_document(request)

# Hecho
print("Document convertired: " + result[0].path)
Convierta JPG a PDF usando una API REST en Python.

Convierta JPG a PDF usando una API REST en Python.

Descarga el PDF convertido

El ejemplo de código anterior guardará el documento PDF convertido en la nube. Se puede descargar usando el siguiente código de ejemplo:

# Este ejemplo de código demuestra cómo descargar un archivo PDF desde la nube.
# Inicialización de la API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# Descargar solicitud de archivo
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# Descargar archivo
response = file_api.download_file(request)

# Mueva el archivo descargado a su directorio de trabajo
shutil.move(response, "C:\\Files\\Conversion\\")

Conversión de JPG a PDF con opciones avanzadas

Podemos convertir documentos JPG a PDF con algunas configuraciones avanzadas mediante programación siguiendo los pasos que se detallan a continuación:

  • En primer lugar, cree una instancia de ConvertApi.
  • A continuación, cree una instancia de ConvertSettings.
  • Luego, configure la ruta del archivo JPG.
  • Y asigne “pdf” al formato.
  • Además, proporcione la ruta del archivo de salida.
  • A continuación, cree una instancia de PdfConvertOptions y asígnela a ConvertSettings.
  • Luego, establezca varias configuraciones de conversión, como ppp, escala de grises, calidad de imagen, altura, márgenes (superior, izquierdo, derecho, inferior), etc.
  • Después de eso, cree ConvertDocumentRequest con ConvertSettings como argumento.
  • Finalmente, llame al método ConvertApi.convert\document() con ConvertDocumentRequest para guardar el archivo convertido.

El siguiente ejemplo de código muestra cómo convertir una imagen JPG en un documento PDF con opciones de conversión avanzadas. Siga los pasos mencionados anteriormente para cargar un archivo de imagen JPG y descargar el archivo PDF convertido.

# Este ejemplo de código demuestra cómo convertirir JPT a PDF con opciones avanzadas.
# Crear las instancias de API necesarias
convertir_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Preparar la configuración de conversión
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "convertired_with_options.pdf"

# Opciones de conversión de 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 solicitud
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# convertir
result = convertir_api.convertir_document(request)

# Hecho
print("Document convertired: " + result[0].path)
Conversión de JPG a PDF con opciones avanzadas.

Conversión de JPG a PDF con opciones avanzadas.

Convierta JPG a PDF con marca de agua en Python

Podemos convertir un documento JPG a PDF y luego agregar una marca de agua al PDF convertido mediante programación siguiendo los pasos que se detallan a continuación:

  • En primer lugar, cree una instancia de ConvertApi.
  • A continuación, cree una instancia de ConvertSettings.
  • Luego, configure la ruta del archivo JPG, asigne “pdf” al formato y proporcione la ruta del archivo de salida.
  • A continuación, cree una instancia de WatermarkOptions.
  • Luego, configure el texto de la marca de agua, el color, el tamaño de la fuente, la rotación, el ángulo, etc.
  • A continuación, cree una instancia de PdfConvertOptions y asígnela a WatermarkOptions.
  • Luego, opcionalmente establezca varias configuraciones de conversión.
  • Y asigne PdfConvertOptions a ConvertSettings.
  • Después de eso, cree ConvertDocumentRequest con ConvertSettings como argumento.
  • Finalmente, llame al método ConvertApi.convert\document() con ConvertDocumentRequest para guardar el archivo convertido.

El siguiente ejemplo de código muestra cómo convertir JPG a un documento PDF y agregar una marca de agua al documento PDF convertido usando una API REST en Python.

# Este ejemplo de código demuestra cómo convertir JPT a PDF y agregar una marca de agua al PDF convertido.
# Inicialización de la API
convert_api = groupdocs_conversion_cloud.ConvertirApi.from_keys(client_id, client_secret)

# Definir la configuración de conversión
settings = groupdocs_conversion_cloud.ConvertirSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"

# Definir opciones de marca de agua
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;

# Definir opciones de conversión de PDF
convertOptions = groupdocs_conversion_cloud.PdfConvertirOptions()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# Crear solicitud de documento de conversión
request = groupdocs_conversion_cloud.ConvertirDocumentRequest(settings)
# Convertir
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
Convierta JPG a PDF con marca de agua en Python.

Convierta JPG a PDF con marca de agua en Python.

Convierta JPG a PDF y descargue el archivo directamente

Podemos convertir JPG a PDF mediante programación y descargar el archivo PDF convertido directamente siguiendo los pasos que se detallan a continuación:

  • En primer lugar, cree una instancia de ConvertApi.
  • A continuación, cree una instancia de ConvertSettings.
  • Luego, configure la ruta del archivo JPG.
  • Y asigne “pdf” al formato.
  • Además, proporcione la ruta del archivo de salida como Ninguna.
  • Después de eso, cree ConvertDocumentRequest con ConvertSettings como argumento.
  • Finalmente, llame al método ConvertApi.convert\document\download() con ConvertDocumentRequest para guardar el archivo convertido en el disco local.

El siguiente ejemplo de código muestra cómo convertir un archivo de imagen JPG en un documento PDF y descargarlo directamente mediante una API REST en Python. La API devolverá el archivo PDF convertido en respuesta. Siga los pasos mencionados anteriormente para cargar un archivo.

# Este ejemplo de código demuestra cómo convertir y descargar.
# Crear las instancias de API necesarias
convert_api = groupdocs_conversion_cloud.ConvertirApi.from_keys(client_id, client_secret)

# Preparar la configuración de conversión
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

# Preparar solicitud
request = groupdocs_conversion_cloud.ConvertirDocumentRequest(settings)

# Convertir
response = convert_api.convert_document_download(request)

# Mueva el archivo descargado a su directorio de trabajo
shutil.move(response, "C:\\Files\\Conversion\\")

Conversión de JPG a PDF sin usar Cloud Storage

Podemos convertir JPG a PDF sin usar el almacenamiento en la nube siguiendo los pasos que se detallan a continuación:

  • En primer lugar, cree una instancia de ConvertApi
  • A continuación, cree ConvertDocumentDirectRequest con el formato de destino y la ruta del archivo de imagen de entrada como argumentos.
  • Luego, llama al método convert\document\direct() con ConvertDocumentDirectRequest como argumento.
  • Finalmente, guarde el archivo PDF de salida convertido en la ruta local usando el método FileStream.writeFile().

El siguiente ejemplo de código muestra cómo convertir JPG a un documento PDF sin utilizar el almacenamiento en la nube. Significa que pasaremos el archivo de entrada en el cuerpo de la solicitud y recibiremos el archivo de salida en la respuesta de la API.

# Este ejemplo de código demuestra cómo convertir JPT a PDF sin usar el almacenamiento en la nube.
# Crear las instancias de API necesarias
convert_api = groupdocs_conversion_cloud.ConvertirApi.from_keys(client_id, client_secret)

# Preparar solicitud
request = groupdocs_conversion_cloud.ConvertirDocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")

# Convertir
result = convert_api.convert_document_direct(request)

# Mueva el archivo descargado a su directorio de trabajo
shutil.move(result, "C:\\Files\\Conversion\\")

Prueba en línea

Pruebe la siguiente herramienta gratuita de conversión de JPG en línea, que se desarrolla utilizando la API anterior. https://products.groupdocs.app/conversion/

Conclusión

En este artículo, hemos aprendido cómo convertir un JPG a un documento PDF en la nube. También hemos visto cómo convertir JPG a PDF y agregar una marca de agua a los documentos convertidos usando Python. Este artículo también explicó cómo cargar mediante programación un archivo de imagen JPG a la nube y luego descargar el archivo PDF convertido desde la nube. Además, puede obtener más información sobre GroupDocs.Conversion Cloud API utilizando la documentación. También proporcionamos una sección Referencia de API que le permite visualizar e interactuar con nuestras API directamente a través del navegador. En caso de cualquier ambigüedad, no dude en contactarnos en el foro.

Ver también