PythonでPDFファイルを圧縮する方法

IronPDFとは何か、なぜPDF圧縮に使うのか？

IronPDFは、PDFドキュメントの作成、読み取り、編集、最適化を処理するPython用PDFライブラリです。 ゼロから生成されたファイル、HTMLから変換されたファイル、またはディスクから読み込まれたファイルで動作します。 その圧縮APIは、PDFの大きさの主な要因である画像をターゲットにしています。

CompressImagesメソッドは1から100までの品質整数と画像を視覚解像度にスケールダウンするオプションのブールを受け入れます。 この二重パラメータデザインでは、圧縮を正確に調整することができます: 高トラフィックのレポートダッシュボードは品質70を使用して視覚的なシャープを維持するかもしれませんが、内部アーカイブシステムは品質40を使用して保存スペースを最大化することができます。 ライブラリはすべてのエンコードを内部で処理するため、追加の依存関係は必要ありません。

IronPDFは、ドキュメントの作成、バーコード処理、OCR、およびZIPアーカイブを含むIron Suiteの一部であり、すべて独自 for Pythonインストールからカバーされています。 ゼロからPDFを作成するために既にIronPDFを使用している開発者にとって、圧縮は保存または配布ファイルの前に行う自然なステップを提供します。

どのようにしてPythonにIronPDFをインストールしますか？

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

:ProductInstall

:ProductInstall

インストール後、本番環境用のライセンスキーを設定してください。 IronPDFには、クレジットカード不要で、すべての機能をカバーする無料の30日間トライアルが含まれています。 PyPIパッケージページには、最新のリリースノートと依存関係の詳細が記載されています。

IronPDFを使用してPDFファイルをどのように圧縮しますか？

品質の整数をCompressImagesに渡すことでドキュメント全体の埋め込まれた画像のサイズを縮小します。 低い整数は、画像の忠実度を犠牲にしてより小さなファイルを生成します; 高い整数は、より多くの詳細を保持します。 以下の例は、標準的な圧縮呼び出しと、画像を表示可能なサイズまで縮小する高度な呼び出しの両方を示しています。

: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")

圧縮後のPDFはどのように表示されますか?

比較では、クオリティ60を使用することで458 KBから357 KBまで減少（およそ22%）していることが示されています。写真コンテンツの割合が高いファイルは、通常、テキストやベクターグラフィックスが主体のファイルよりも大きな削減を達成します。

私のお気に入りのこの種のライブラリはIronPDFです。PDFファイルの迅速で効率的な操作が可能です。また、PDF/A形式へのエクスポートやPDF文書へのデジタル署名といった多くの貴重な機能も備えています。

Milan Jovanovic

Microsoft MVP

ケーススタディを見る

IronOCRのおかげで私たちは年間$40,000を手作業の処理から節約し、生産性を向上させ、高影響のタスクにリソースを充てることができます。非常にお勧めします。

Brent Matzelle

最高技術責任者, OPYN

ケーススタディを見る

IronSuiteは私たちの業務において重要な役割を果たしています。これらは、フロアプランの作成や在庫管理の改善を含め、ビジネス全体の効率を向上させるツールです。

David Jones

リードソフトウェアエンジニア、Agorus Build

ケーススタディを見る

複数のPDFファイルにバッチ圧縮を適用する方法は？

PDFファイルのフォルダを処理するには同じAPIを使用します：各CompressImagesを呼び出し結果を保存します。 以下の関数は、そのパターンを再利用可能なユーティリティに包みます。

: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}")

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}")

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}")

exceptブロックにより、単一の破損またはパスワード保護されたファイルでバッチ全体が中断されないようにします。 例外メッセージと一緒にファイル名をログに記録することで、どのファイルが手動レビューを必要としているかを特定しやすくなります。 大量パイプラインの場合、フォルダをチャンクに分割し、並列スレッドで処理することを検討してください。

PDF圧縮にどの品質設定を使用すべきですか？

圧縮後にPDFをどのように使用するかに応じて、適切な品質設定が決まります。 3つの範囲で最も一般的なシナリオをカバーします。

高品質（70〜90）：印刷や正式な配布に向けた文書は、この範囲を維持することでメリットがあります。 テキストは鮮明に保たれ、図面は標準印刷解像度でも読み取りやすく残ります。 ファイルのサイズ削減は控えめで、通常10〜25%ですが、出力はほとんどの読者にとってソースと区別がつきません。

中品質 (50–70): この範囲はウェブ配信やメール添付に適しています。 写真の内容は詳しく見るとわずかにソフトに見えることがありますが、ファイルサイズの削減（通常25-50％）により、読み込み時間やメール配信性が大幅に改善されます。 ほとんどのドキュメント管理システムとポータルのアップロードは、品質60でうまく動作します。

アグレッシブ圧縮 (30–50): 内部アーカイブ、長期間のストレージバックアップ、印刷されないドキュメントはこの範囲を使用できます。 品質40では、画像が明らかに柔らかくなりますが、PDFエンジンによってレンダリングされたテキスト（画像として埋め込まれているのではなく）は完全に鮮明なままです。このアプローチは、画像に変換され、表示前にサイズ変更されるドキュメントにも適しています。

Pythonで圧縮結果をどのように検証しますか？

出力ファイルサイズをプログラム上で確認すると、圧縮がターゲットに達したかどうかが確認されパイプラインの次のステップに進む前に、Pythonの組み込みのos.path.getsizeは任意のファイルパスのバイト数を返すので、検証には追加のライブラリは必要ありません。

: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}%")

出力には、ログを記録したり、しきい値と照らし合わせて確認できる明確な削減率が示されます。 削減が期待を下回る場合、ドキュメントには埋め込み画像がほとんどないか、全く含まれない可能性があります。 その場合、CompressImagesがラスタ画像のみをターゲットにしているため、画像の品質設定に関係なくファイルサイズはほとんど変化しません。 この方法によって、テキストとベクトルグラフィックスは影響を受けません。

PythonでのPDF圧縮の次のステップは何ですか？

IronPDFのCompressImagesメソッドは、Python開発者にPDFファイルサイズを縮小するための単一で適切に範囲を持つAPIを提供します。 品質パラメータを調整して、ストレージの節約と視覚的な忠実性のバランスを取り、出力寸法が固定されている場合に第二の削減パス用として解像度スケーリングのブール値を追加します。 IronPDFが取り扱う内容のより広範な概要については、Python PDFライブラリの概要ページをご覧ください。

無料トライアルを開始して、HTMLからPDFへの変換、デジタル署名、フォーム処理、ドキュメントの結合を含むIronPDFのフル機能セットと共に圧縮をテストしてください。 トライアル期間が終了したら、ライセンスオプションを表示して、デプロイメントに適したプランを見つけてください。

IronPDFの他の機能をご覧になりたいですか？ IronPDFの主要な機能を詳しく紹介するPython PDFチュートリアルをご覧ください。