Cómo comprimir archivos PDF en Python

¿Qué es IronPDF y por qué utilizarlo para la compresión de PDF?

IronPDF es una biblioteca de PDF en Python que maneja la creación, lectura, edición y optimización de documentos PDF. Funciona con archivos generados desde cero, convertidos desde HTML o cargados desde el disco. Su API de compresión apunta a imágenes, que son el principal contribuyente a los grandes tamaños de PDF.

El método CompressImages acepta un entero de calidad de 1 a 100 y un booleano opcional que escala las imágenes a su resolución visible. Este diseño de parámetros dobles le permite ajustar la compresión con precisión: un panel de informes de alto tráfico podría usar calidad 70 para mantener las visuales nítidas, mientras que un sistema de archivo interno podría usar calidad 40 para maximizar el ahorro de almacenamiento. La biblioteca maneja toda la codificación internamente, por lo que no se requieren dependencias adicionales.

IronPDF es parte de Iron Suite, que cubre la creación de documentos, procesamiento de códigos de barras, OCR y archivado ZIP, todo desde una instalación compartida de Python. Para los desarrolladores que ya utilizan IronPDF para crear PDFs desde cero, la compresión se inserta como un paso natural antes de guardar o distribuir archivos.

¿Cómo se instala IronPDF en Python?

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/install.sh
:ProductInstall

// ¡ESTE FRAGMENTO DE CÓDIGO NO ESTÁ DISPONIBLE!
:ProductInstall

Después de la instalación, configure su clave de licencia para ambientes de producción. IronPDF incluye una prueba gratuita de 30 días que cubre todas las características, incluida la compresión, sin necesidad de tarjeta de crédito. La página del paquete en PyPI enumera las notas de la última versión y detalles de dependencias.

¿Cómo se comprimen archivos PDF usando IronPDF?

Pasa un entero de calidad a CompressImages para reducir el tamaño de las imágenes incrustadas en todo el documento. Los enteros más bajos producen archivos más pequeños a costa de la fidelidad de la imagen; los enteros más altos preservan más detalles. El ejemplo a continuación muestra tanto una llamada de compresión estándar como una llamada avanzada que también reduce las imágenes a su tamaño visible.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/compress-basic.py
from ironpdf import PdfDocument

# Load the PDF document from a file
pdf = PdfDocument("Image based PDF.pdf")

# Compress images to quality 60 (lower numbers increase compression)
pdf.CompressImages(60)
pdf.SaveAs("document_compressed.pdf")

# Advanced: also scale images down to their visible size in the PDF
# Note: scaling can affect image clarity if pages are resized later
pdf.CompressImages(90, True)
pdf.SaveAs("Compressed.pdf")

// ¡ESTE FRAGMENTO DE CÓDIGO NO ESTÁ DISPONIBLE!
from ironpdf import PdfDocument

# Load the PDF document from a file
pdf = PdfDocument("Image based PDF.pdf")

# Compress images to quality 60 (lower numbers increase compression)
pdf.CompressImages(60)
pdf.SaveAs("document_compressed.pdf")

# Advanced: also scale images down to their visible size in the PDF
# Note: scaling can affect image clarity if pages are resized later
pdf.CompressImages(90, True)
pdf.SaveAs("Compressed.pdf")

¿Cómo Aplicar Compresión por Lotes a Archivos PDF Múltiples?

Procesar una carpeta de archivos PDF sigue la misma API: itera sobre cada archivo .pdf, cárgalo con PdfDocument, llama a CompressImages, y guarda el resultado. La función a continuación envuelve ese patrón en una utilidad reutilizable.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/batch-compress.py
import os
from ironpdf import PdfDocument

def batch_compress_pdfs(input_folder, output_folder, quality=60):
    """
    Compress all PDF files in a folder.

    Args:
        input_folder: Path to folder containing source PDFs
        output_folder: Path where compressed PDFs will be saved
        quality: Compression quality (1–100); default is 60
    """
    # Create the output folder if it does not exist
    os.makedirs(output_folder, exist_ok=True)

    for filename in os.listdir(input_folder):
        if filename.endswith(".pdf"):
            input_path = os.path.join(input_folder, filename)
            output_path = os.path.join(output_folder, f"compressed_{filename}")

            try:
                pdf = PdfDocument(input_path)
                pdf.CompressImages(quality)
                pdf.SaveAs(output_path)
                print(f"Compressed: {filename}")
            except Exception as e:
                print(f"Error compressing {filename}: {e}")

// ¡ESTE FRAGMENTO DE CÓDIGO NO ESTÁ DISPONIBLE!
import os
from ironpdf import PdfDocument

def batch_compress_pdfs(input_folder, output_folder, quality=60):
    """
    Compress all PDF files in a folder.

    Args:
        input_folder: Path to folder containing source PDFs
        output_folder: Path where compressed PDFs will be saved
        quality: Compression quality (1–100); default is 60
    """
    # Create the output folder if it does not exist
    os.makedirs(output_folder, exist_ok=True)

    for filename in os.listdir(input_folder):
        if filename.endswith(".pdf"):
            input_path = os.path.join(input_folder, filename)
            output_path = os.path.join(output_folder, f"compressed_{filename}")

            try:
                pdf = PdfDocument(input_path)
                pdf.CompressImages(quality)
                pdf.SaveAs(output_path)
                print(f"Compressed: {filename}")
            except Exception as e:
                print(f"Error compressing {filename}: {e}")

El bloque except evita que un solo archivo corrupto o protegido con contraseña detenga todo el lote. Registrar el nombre del archivo junto con el mensaje de excepción facilita identificar qué archivos necesitan revisión manual. Para canales de mayor volumen, considere dividir la carpeta en partes y procesarlas en hilos paralelos.

¿Qué Configuraciones de Calidad Debería Usar para la Compresión de PDF?

La configuración de calidad adecuada depende de cómo se utilizará el PDF después de la compresión. Tres rangos cubren los escenarios más comunes.

Alta calidad (70–90): Los documentos destinados a la impresión o distribución formal se benefician de permanecer en este rango. El texto permanece nítido y los diagramas siguen siendo legibles a resoluciones de impresión estándar. La reducción del tamaño del archivo es modesta, típicamente del 10 al 25%, pero la salida es indistinguible de la fuente para la mayoría de los lectores.

Calidad media (50–70): Este rango se adapta a la entrega web y a los adjuntos de correo electrónico. El contenido fotográfico muestra un ligero suavizado en una inspección cercana, pero la reducción del tamaño del archivo (a menudo del 25 al 50%) mejora significativamente los tiempos de carga y la entrega de correos electrónicos. La mayoría de los sistemas de gestión de documentos y las cargas en portales funcionan bien a calidad 60.

Compresión agresiva (30–50): Archivos de archivo interno, copias de seguridad de almacenamiento a largo plazo y documentos que no se imprimirán pueden usar este rango. A calidad 40, las imágenes son notablemente más suaves, pero el texto renderizado por el motor PDF (en lugar de incrustado como imágenes) permanece completamente claro. Este enfoque también es adecuado para documentos que se convertirán a imágenes y se cambiarán de tamaño antes de mostrarse.

¿Cómo Verificar los Resultados de la Compresión en Python?

Comprobar el tamaño del archivo de salida programáticamente confirma que la compresión alcanzó tu objetivo antes de que el archivo pase al siguiente paso en una tubería. El os.path.getsize incorporado en Python devuelve el conteo de bytes para cualquier ruta de archivo, por lo que la verificación no requiere bibliotecas adicionales.

:path=/static-assets/ironpdf-python/content-code-examples/how-to/python-compress-pdf/verify-compression.py
import os
from ironpdf import PdfDocument

# Load and compress the document
pdf = PdfDocument("report.pdf")
original_size = os.path.getsize("report.pdf")

pdf.CompressImages(60)
pdf.SaveAs("report_compressed.pdf")

compressed_size = os.path.getsize("report_compressed.pdf")
reduction_pct = (1 - compressed_size / original_size) * 100

# Report results to confirm compression was effective
print(f"Original:   {original_size / 1024:.1f} KB")
print(f"Compressed: {compressed_size / 1024:.1f} KB")
print(f"Reduction:  {reduction_pct:.1f}%")

// ¡ESTE FRAGMENTO DE CÓDIGO NO ESTÁ DISPONIBLE!
import os
from ironpdf import PdfDocument

# Load and compress the document
pdf = PdfDocument("report.pdf")
original_size = os.path.getsize("report.pdf")

pdf.CompressImages(60)
pdf.SaveAs("report_compressed.pdf")

compressed_size = os.path.getsize("report_compressed.pdf")
reduction_pct = (1 - compressed_size / original_size) * 100

# Report results to confirm compression was effective
print(f"Original:   {original_size / 1024:.1f} KB")
print(f"Compressed: {compressed_size / 1024:.1f} KB")
print(f"Reduction:  {reduction_pct:.1f}%")

La salida da un claro porcentaje de reducción que se puede registrar o verificar contra un umbral. Si la reducción cae por debajo de las expectativas, el documento puede contener pocas o ninguna imagen incrustada. En ese caso, el tamaño del archivo permanecerá prácticamente sin cambios independientemente de la configuración de calidad, ya que CompressImages solo apunta a imágenes rasterizadas. El texto y los gráficos vectoriales no se ven afectados por este método.

¿Cuáles Son los Próximos Pasos para la Compresión de PDF en Python?

El método CompressImages de IronPDF ofrece a los desarrolladores de Python una API única y bien definida para reducir el tamaño de los archivos PDF. Ajuste el parámetro de calidad para equilibrar el ahorro de almacenamiento frente a la fidelidad visual, y agregue el booleano de escalado de resolución para un segundo paso de reducción cuando las dimensiones de salida estén fijas. Para una visión más amplia de lo que maneja IronPDF, consulte la página de visión general de la biblioteca de PDF for Python.

Comience su prueba gratuita para probar la compresión junto con el conjunto completo de funciones de IronPDF, incluyendo conversión de HTML a PDF, firmas digitales, manejo de formularios y fusión de documentos. Cuando termine el período de prueba, vea las opciones de licencia para encontrar el plan que se adapte a su implementación.

¿Listo para ver qué más puede hacer IronPDF? Explore el completo tutorial de PDF for Python para un recorrido por las capacidades principales de IronPDF.