Python で REST API を使用して画像を PDF に変換する

PDF は、ドキュメントの共有と印刷によく使われる形式の 1 つです。さまざまな形式のドキュメントや画像を PDF に変換する必要があることがよくあります。このようなツールの開発には多くの時間と労力が必要です。したがって、ニーズに合わせて保守が容易で柔軟なソリューションを提供する、すでに開発された専用ツールを使用することをお勧めします。この目的のために、画像から PDF への変換 REST API と Python SDK を使用して、サポートされている形式のドキュメントをクラウド上でプログラム的に PDF に変換できます。この記事では、Python の REST API を使用して画像を PDF に変換する方法を学びます。

この記事では次のトピックについて説明します。

画像から PDF への変換 REST API と Python SDK
Python の REST API を使用して JPG を PDF に変換する
高度なオプションを使用した JPG から PDF への変換
Pythonで透かしを入れてJPGをPDFに変換する
JPGをPDFに変換してファイルを直接ダウンロード
クラウドストレージを使用しないJPGからPDFへの変換

画像から PDF への変換 REST API と Python SDK

JPG または PNG 画像を PDF に変換するには、GroupDocs.Conversion Cloud の Python SDK API を使用します。コンソールで次のコマンドを使用してインストールしてください。

pip install groupdocs_converison_cloud

上記の手順に従う前に、ダッシュボードからクライアント ID とシークレットを取得してください。 ID とシークレットを取得したら、以下に示すようにコードを追加します。

# このコード例は、クライアント ID とシークレットを設定する方法を示しています。
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 = ""

Python の REST API を使用して JPG を PDF に変換する

以下の簡単な手順に従って、画像を PDF ドキュメントに変換できます。

JPG画像ファイルをクラウドにアップロード
Python を使用して JPG を PDF に変換
ダウンロード変換されたPDFファイル

画像をアップロードする

まず、次のコードサンプルを使用して、JPG 画像ファイルをクラウドにアップロードします。

# このコード例は、JPG 画像ファイルをクラウドにアップロードする方法を示しています。
# APIのインスタンスを作成する
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# ファイルのアップロードリクエスト
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)

# サンプルファイルをアップロードする
response = file_api.upload_file(request)

その結果、アップロードされたファイルはクラウド上のダッシュボードのファイルセクションで利用できるようになります。

Pythonを使用してJPGをPDFに変換する

以下の手順に従って、プログラムで JPG 画像を PDF ドキュメントに変換できます。

まず、ConvertApi のインスタンスを作成します。
次に、ConvertSettings のインスタンスを作成します。
次に、JPG ファイルのパスを設定します。
そして、形式に「pdf」を割り当てます。
また、出力ファイルのパスも指定します。
その後、ConvertSettings を引数として ConvertDocumentRequest を作成します。
最後に、ConvertDocumentRequest を指定して ConvertApi.convert\document() メソッドを呼び出し、変換されたファイルを保存します。

次のコードサンプルは、Python の REST API を使用して JPG 画像を PDF ドキュメントに変換する方法を示しています。

# このコード例は、JPT を PDF に変換する方法を示します。
# 必要なAPIインスタンスを作成する
変換_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# 変換設定を準備する
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "変換ed"

# 変換リクエスト
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# 変換
result = 変換_api.変換_document(request)

# 終わり
print("Document 変換ed: " + result[0].path)

Python の REST API を使用して JPG を PDF に変換します。

変換された PDF をダウンロードする

上記のコードサンプルは、変換された PDF ドキュメントをクラウド上に保存します。次のコード例を使用してダウンロードできます。

# このコード例は、クラウドから PDF ファイルをダウンロードする方法を示しています。
# APIの初期化
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# ファイルのダウンロード要求
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# ダウンロードファイル
response = file_api.download_file(request)

# ダウンロードしたファイルを作業ディレクトリに移動します
shutil.move(response, "C:\\Files\\Conversion\\")

高度なオプションを使用した JPG から PDF への変換

以下の手順に従って、プログラムで高度な設定を使用して JPG を PDF ドキュメントに変換できます。

まず、ConvertApi のインスタンスを作成します。
次に、ConvertSettings のインスタンスを作成します。
次に、JPG ファイルのパスを設定します。
そして、形式に「pdf」を割り当てます。
また、出力ファイルのパスも指定します。
次に、PdfConvertOptions のインスタンスを作成し、ConvertSettings に割り当てます。
次に、dpi、グレースケール、画像\品質、高さ、マージン (上、左、右、下) などのさまざまな変換設定を設定します。
その後、ConvertSettings を引数として ConvertDocumentRequest を作成します。
最後に、ConvertDocumentRequest を指定して ConvertApi.convert\document() メソッドを呼び出し、変換されたファイルを保存します。

次のコード例は、高度な変換オプションを使用して JPG 画像を PDF ドキュメントに変換する方法を示しています。前述の手順に従って、JPG 画像ファイルをアップロードし、変換された PDF ファイルをダウンロードしてください。

# このコード例は、詳細オプションを使用して JPT を PDF に変換する方法を示します。
# 必要なAPIインスタンスを作成する
変換_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# 変換設定を準備する
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "変換ed_with_options.pdf"

# PDF変換オプション
変換Options = groupdocs_conversion_cloud.PdfConvertOptions()
変換Options.center_window = True
変換Options.display_doc_title = True
変換Options.dpi = 1024.0
変換Options.fit_window = False
変換Options.grayscale = True
変換Options.image_quality = 100
変換Options.linearize = True
変換Options.margin_top = 500
変換Options.margin_left = 500
変換Options.margin_right = 500
変換Options.margin_bottom = 500

settings.変換_options = 変換Options

# 変換リクエスト
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# 変換
result = 変換_api.変換_document(request)

# 終わり
print("Document 変換ed: " + result[0].path)

Pythonで透かしを入れてJPGをPDFに変換する

以下の手順に従って、JPG を PDF ドキュメントに変換し、変換された PDF にプログラムでウォーターマークを追加できます。

まず、ConvertApi のインスタンスを作成します。
次に、ConvertSettings のインスタンスを作成します。
次に、JPG ファイルのパスを設定し、形式に「pdf」を割り当て、出力ファイルのパスを指定します。
次に、WatermarkOptions のインスタンスを作成します。
次に、透かしのテキスト、色、フォント\サイズ、回転\角度などを設定します。
次に、PdfConvertOptions のインスタンスを作成し、WatermarkOptions に割り当てます。
次に、必要に応じてさまざまな変換設定を設定します。
そして、ConvertSettings に PdfConvertOptions を割り当てます。
その後、ConvertSettings を引数として ConvertDocumentRequest を作成します。
最後に、ConvertDocumentRequest を指定して ConvertApi.convert\document() メソッドを呼び出し、変換されたファイルを保存します。

次のコード例は、Python の REST API を使用して JPG を PDF ドキュメントに変換し、変換された PDF ドキュメントにウォーターマークを追加する方法を示しています。

# このコード例は、JPT を PDF に変換し、変換された PDF にウォーターマークを追加する方法を示します。
# APIの初期化
convert_api = groupdocs_conversion_cloud.変換Api.from_keys(client_id, client_secret)

# 変換設定を定義する
settings = groupdocs_conversion_cloud.変換Settings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"

# 透かしオプションを定義する
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;

# PDF 変換オプションを定義する
convertOptions = groupdocs_conversion_cloud.Pdf変換Options()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# 変換ドキュメントリクエストの作成
request = groupdocs_conversion_cloud.変換DocumentRequest(settings)
# 変換
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)

JPGをPDFに変換してファイルを直接ダウンロード

以下の手順に従って、プログラムで JPG を PDF に変換し、変換された PDF ファイルを直接ダウンロードできます。

まず、ConvertApi のインスタンスを作成します。
次に、ConvertSettings のインスタンスを作成します。
次に、JPG ファイルのパスを設定します。
そして、形式に「pdf」を割り当てます。
また、出力ファイルのパスを「なし」として指定します。
その後、ConvertSettings を引数として ConvertDocumentRequest を作成します。
最後に、ConvertDocumentRequest を指定して ConvertApi.convert\document\download() メソッドを呼び出し、変換されたファイルをローカルディスクに保存します。

次のコードサンプルは、Python の REST API を使用して JPG 画像ファイルを PDF ドキュメントに変換し、直接ダウンロードする方法を示しています。 API は、応答として変換された PDF ファイルを返します。前述の手順に従ってファイルをアップロードしてください。

# このコード例は、変換およびダウンロードする方法を示しています。
# 必要なAPIインスタンスを作成する
convert_api = groupdocs_conversion_cloud.変換Api.from_keys(client_id, client_secret)

# 変換設定を準備する
settings = groupdocs_conversion_cloud.変換Settings()
settings.file_path = "sample.jpg"
settings.format = "pdf"

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

# リクエストの準備
request = groupdocs_conversion_cloud.変換DocumentRequest(settings)

# 変換
response = convert_api.convert_document_download(request)

# ダウンロードしたファイルを作業ディレクトリに移動します
shutil.move(response, "C:\\Files\\Conversion\\")

クラウドストレージを使用しないJPGからPDFへの変換

以下の手順に従って、クラウドストレージを使用せずに JPG を PDF に変換できます。

まず、ConvertApi のインスタンスを作成します。
次に、ターゲット形式と入力画像ファイルのパスを引数として ConvertDocumentDirectRequest を作成します。
次に、ConvertDocumentDirectRequest を引数として convert\document\direct() メソッドを呼び出します。
最後に、FileStream.writeFile() メソッドを使用して、変換された出力 PDF ファイルをローカルパスに保存します。

次のコードサンプルは、クラウドストレージを使用せずに JPG を PDF ドキュメントに変換する方法を示しています。これは、リクエスト本文で入力ファイルを渡し、API レスポンスで出力ファイルを受け取ることを意味します。

# このコード例は、クラウド ストレージを使用せずに JPT を PDF に変換する方法を示しています。
# 必要なAPIインスタンスを作成する
convert_api = groupdocs_conversion_cloud.変換Api.from_keys(client_id, client_secret)

# リクエストの準備
request = groupdocs_conversion_cloud.変換DocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")

# 変換
result = convert_api.convert_document_direct(request)

# ダウンロードしたファイルを作業ディレクトリに移動します
shutil.move(result, "C:\\Files\\Conversion\\")

オンラインで試す

上記の API を使用して開発された、次の無料のオンライン JPG 変換ツールをお試しください。 https://products.groupdocs.app/conversion/

結論

この記事では、クラウド上で JPG を PDF ドキュメントに変換する方法を学びました。また、Python を使用して JPG を PDF に変換し、変換されたドキュメントにウォーターマークを追加する方法についても説明しました。この記事では、プログラムで JPG 画像ファイルをクラウドにアップロードし、変換された PDF ファイルをクラウドからダウンロードする方法についても説明しました。さらに、ドキュメントを使用して、GroupDocs.Conversion Cloud API について詳しく学ぶことができます。また、ブラウザーを通じて API を直接視覚化して操作できる API リファレンスセクションも提供しています。不明な点がある場合は、フォーラムでお気軽にお問い合わせください。

画像から PDF への変換 REST API と Python SDK#

Python の REST API を使用して JPG を PDF に変換する#

画像をアップロードする#

Pythonを使用してJPGをPDFに変換する#

変換された PDF をダウンロードする#

高度なオプションを使用した JPG から PDF への変換#

Pythonで透かしを入れてJPGをPDFに変換する#

JPGをPDFに変換してファイルを直接ダウンロード#

クラウドストレージを使用しないJPGからPDFへの変換#

オンラインで試す#

結論#

関連項目#