Como compactar arquivos PDF em Python

O que é o IronPDF e por que usá-lo para compressão de PDF?

O IronPDF é uma biblioteca PDF for Python que lida com criação, leitura, edição e otimização de documentos PDF. Funciona com arquivos gerados do zero, convertidos de HTML, ou carregados do disco. Sua API de compressão tem como alvo imagens, que são o principal contribuinte para tamanhos grandes de PDF.

O método CompressImages aceita um número inteiro de qualidade de 1 a 100 e um valor booleano opcional que redimensiona as imagens para sua resolução visível. Esse design de dois parâmetros permite ajustar a compressão precisamente: um painel de relatórios de alto tráfego pode usar qualidade 70 para manter visuais nítidos, enquanto um sistema de arquivo interno pode usar qualidade 40 para maximizar a economia de armazenamento. A biblioteca lida com toda a codificação internamente, então nenhuma dependência adicional é necessária.

O IronPDF é parte do Iron Suite, que cobre criação de documentos, processamento de códigos de barras, OCR, e arquivamento ZIP, tudo a partir de uma instalação Python compartilhada. Para desenvolvedores que já usam o IronPDF para criar PDFs do zero, a compressão se encaixa como um passo de acompanhamento natural antes de salvar ou distribuir arquivos.

Como você instala o IronPDF em Python?

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

// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
:ProductInstall

Após a instalação, configure sua chave de licença para ambientes de produção. O IronPDF inclui um teste gratuito de 30 dias que cobre todas as funcionalidades, incluindo compressão, sem necessidade de cartão de crédito. A página do pacote PyPI lista as últimas notas de lançamento e detalhes sobre dependências.

Como você comprime arquivos PDF usando o IronPDF?

Passe um número inteiro de qualidade para CompressImages para reduzir o tamanho das imagens incorporadas em todo o documento. Inteiros mais baixos produzem arquivos menores à custa da fidelidade da imagem; inteiros mais altos preservam mais detalhes. O exemplo abaixo mostra tanto uma chamada de compressão padrão quanto uma chamada avançada que também reduz a escala das imagens para o seu tamanho visível.

: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 TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
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")

Como Aplicar Compressão em Lote a Múltiplos Arquivos PDF?

O processamento de uma pasta de arquivos PDF segue a mesma API: itere sobre cada arquivo .pdf, carregue-o com PdfDocument, chame CompressImages e salve o resultado. A função abaixo envolve esse padrão em um utilitário reutilizável.

: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 TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
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}")

O bloco except impede que um único arquivo corrompido ou protegido por senha interrompa todo o lote. Registrar o nome do arquivo junto à mensagem de exceção facilita a identificação de quais arquivos precisam de revisão manual. Para pipelines de maior volume, considere dividir a pasta em partes e processá-las em threads paralelos.

Quais Configurações de Qualidade Usar para Compressão de PDF?

A configuração de qualidade correta depende de como o PDF será usado após a compressão. Três intervalos cobrem os cenários mais comuns.

Alta qualidade (70–90): Documentos destinados à impressão ou distribuição formal beneficiam-se ao permanecer neste intervalo. O texto permanece nítido e os diagramas continuam legíveis nas resoluções padrão de impressão. A redução do tamanho do arquivo é modesta, tipicamente 10–25%, mas o resultado é indistinguível da fonte para a maioria dos leitores.

Qualidade média (50–70): Este intervalo é adequado para entrega web e anexos de e-mail. O conteúdo fotográfico mostra um leve amolecimento sob inspeção minuciosa, mas a redução no tamanho do arquivo (frequentemente 25–50%) melhora significativamente os tempos de carregamento e a entrega por e-mail. A maioria dos sistemas de gerenciamento de documentos e upload em portais funciona bem com qualidade 60.

Compressão agressiva (30–50): Arquivos internos, backups de armazenamento de longo prazo, e documentos que não serão impressos podem usar este intervalo. Na qualidade 40, as imagens são visivelmente mais suaves, mas o texto renderizado pelo motor PDF (em vez de embutido como imagens) permanece totalmente nítido. Esta abordagem também é apropriada para documentos que serão convertidos para imagens e redimensionados antes da exibição.

Como Verificar Resultados de Compressão em Python?

Verificar o tamanho do arquivo de saída programaticamente confirma se a compressão atingiu o objetivo antes que o arquivo passe para a próxima etapa do pipeline. A função integrada do Python, __str__, retorna a contagem de bytes para qualquer caminho de arquivo, portanto, a verificação não requer bibliotecas adicionais.

: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 TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
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}%")

A saída fornece uma porcentagem clara de redução que pode ser registrada ou verificada com um limite. Se a redução ficar abaixo das expectativas, o documento pode conter poucas ou nenhumas imagens embutidas. Nesse caso, o tamanho do arquivo permanecerá praticamente inalterado, independentemente da configuração de qualidade, já que CompressImages tem como alvo apenas imagens rasterizadas. Texto e gráficos vetoriais não são afetados por este método.

Quais São os Próximos Passos para Compressão de PDF em Python?

O método CompressImages do IronPDF oferece aos desenvolvedores Python uma API única e bem definida para reduzir o tamanho de arquivos PDF. Ajuste o parâmetro de qualidade para equilibrar economias de armazenamento contra a fidelidade visual, e adicione o booleano de escala de resolução para uma segunda passagem de redução quando as dimensões de saída forem fixas. Para uma visão mais ampla do que o IronPDF pode fazer, veja a página de visão geral da biblioteca de PDF for Python.

Comece seu teste gratuito para testar a compressão junto ao conjunto completo de recursos do IronPDF, incluindo conversão de HTML para PDF, assinaturas digitais, manipulação de formulários e junção de documentos. Quando o período de teste terminar, veja as opções de licenciamento para encontrar o plano que se encaixa na sua implantação.

Pronto para ver o que mais o IronPDF pode fazer? Explore o tutorial completo de PDF for Python para um passo a passo das capacidades principais do IronPDF.