PSD ファイルを JPG 画像に変換することは、Web やモバイル アプリケーション用のアセットを準備する際に頻繁に必要とされます。
Aspose.HTML Cloud SDK for Python は、開発者が Python で数行のコードだけで高品質な PSD から JPG への変換を実行できるようにします。
このチュートリアルでは、完全なコード例を確認し、cURL を使用して REST 経由で同じ操作を呼び出す方法を学び、画像品質とパフォーマンスを最適化するためのヒントを紹介します。
Python で高品質な PSD から JPG への変換 - 完全コード例
この例では、Aspose.HTML Cloud SDK for Python を使用して PSD ファイルを JPG 画像に変換する方法を示します。
import os
from asposehtmlcloud import HtmlApi, Configuration, ConvertOptions, ApiException, ApiClient
# -------------------- Configuration --------------------
# Replace with your actual Aspose Cloud credentials
config = Configuration()
config.client_id = "YOUR_CLIENT_ID"
config.client_secret = "YOUR_CLIENT_SECRET"
# Optional: set a custom API base URL if needed
# config.host = "https://api.aspose.cloud"
api_client = ApiClient(config)
html_api = HtmlApi(api_client)
# -------------------- Input / Output Paths --------------------
input_psd_path = "sample.psd" # Path to the source PSD file
output_jpg_path = "sample_converted.jpg" # Desired output JPG file
# -------------------- Conversion Options --------------------
convert_options = ConvertOptions()
convert_options.format = "jpg" # Target format
convert_options.width = 1920 # Resize width (optional)
convert_options.height = 1080 # Resize height (optional)
convert_options.jpeg_quality = 90 # JPEG quality (0‑100)
convert_options.use_cmyk = False # Use CMYK color space if needed
convert_options.optimize_image = True # Enable performance optimizations
# -------------------- Conversion Execution --------------------
try:
# The SDK reads the local file, uploads it to Aspose Cloud, performs conversion,
# and returns the resulting bytes.
with open(input_psd_path, "rb") as input_file:
result_bytes = html_api.convert_document(
file_content=input_file.read(),
convert_options=convert_options
)
# Write the resulting JPG to disk
with open(output_jpg_path, "wb") as out_file:
out_file.write(result_bytes)
print(f"Conversion successful: '{input_psd_path}' → '{output_jpg_path}'")
except ApiException as e:
print("API error during conversion:")
print(f"Status: {e.status}")
print(f"Reason: {e.reason}")
print(f"Body: {e.body}")
except Exception as ex:
print(f"Unexpected error: {ex}")
finally:
# Cleanup: if any temporary files were created by the SDK they are removed automatically.
# Explicit cleanup can be added here if needed.
pass
Note: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値を実際の環境に合わせて更新し、必要な依存関係がすべて正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメント または サポートチーム にお問い合わせください。
cURL を使用した REST API で PSD ファイルを JPG に変換
コードを書かずに Aspose.HTML Cloud の REST エンドポイントを直接呼び出すことで、同じ結果を得ることができます。以下の手順では、認証、PSD のアップロード、変換リクエスト、JPG のダウンロード方法を示します。
# 1. Get an access token
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
以下のコマンドで YOUR_ACCESS_TOKEN を、上記で返されたトークンに置き換えてください。
# 2. Upload the PSD file
curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/sample.psd" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@sample.psd"
# 3. Convert the uploaded PSD to JPG
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=jpg&jpegQuality=90&optimizeImage=true" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"inputPath":"sample.psd","outputPath":"sample_converted.jpg"}'
# 4. Download the resulting JPG
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/sample_converted.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "sample_converted.jpg"
リクエスト パラメータの詳細については、公式 API ドキュメントをご覧ください。
PythonでのPSDからJPGへの変換の仕組み
SDKは変換ワークフローをいくつかの明確な手順に抽象化します:
- 構成設定 -
Configuration()はクライアント資格情報を保持します。
config = Configuration()
config.client_id = "YOUR_CLIENT_ID"
config.client_secret = "YOUR_CLIENT_SECRET"
- API クライアントの初期化 -
ApiClientは低レベルの HTTP クライアントを作成し、HtmlApiは高レベルのメソッドを提供します。
api_client = ApiClient(config)
html_api = HtmlApi(api_client)
- 変換オプションの定義 -
ConvertOptions()を使用すると、フォーマット、寸法、JPEG の品質、パフォーマンスフラグを指定できます。
convert_options = ConvertOptions()
convert_options.format = "jpg"
convert_options.jpeg_quality = 90
convert_options.optimize_image = True
- ファイルのアップロードと変換 -
convert_documentはローカルの PSD を読み取り、アップロードし、クラウド上で変換を実行し、JPG バイトを返します。
with open(input_psd_path, "rb") as input_file:
result_bytes = html_api.convert_document(
file_content=input_file.read(),
convert_options=convert_options
)
- 結果の保存 - 返されたバイト配列はディスク上のファイルに書き込まれます。
with open(output_jpg_path, "wb") as out_file:
out_file.write(result_bytes)
このフローは、Python で PSD から JPG への変換を効率的に実行し、Aspose のクラウドインフラストラクチャを活用します。
PSD から JPG への変換の前提条件とセットアップ
開始する前に、以下が揃っていることを確認してください：
- Python 3.7 以降がインストールされていること。
- Aspose Cloud アカウント（クライアント ID とクライアント シークレット）があること。
- Aspose の API エンドポイントへのネットワークアクセス。
pip を使用して SDK をインストールします:
pip install asposehtmlcloud
パッケージはリリースページから直接ダウンロードすることもできます。
インストール後、コードの設定セクションに資格情報を配置してください（上記の完全な例を参照）。
PSD から JPG への変換を最適化するベストプラクティス
- PythonでPSDをJPGに変換する自動化 - PSDファイルが格納されたディレクトリを反復処理し、単一の
HtmlApiインスタンスを再利用することで。 - PythonでPSDからJPGへの変換を最適化 -
jpeg_qualityを80〜95に設定し、optimize_imageを有効にすることで、目立った品質低下なしにファイルサイズを削減します。 - 適切なサイズを使用する - 大きなPSDを対象の幅/高さにリサイズして、不要な処理時間を回避します。
- 例外を適切に処理する -
ApiExceptionを捕捉して API エラーを記録し、必要に応じて再試行します。 - API クライアントを再利用する - 各ファイルごとに新しいクライアントを作成するとオーバーヘッドが増えるため、バッチごとに1つのクライアントを保持します。
結論
Python で Aspose.HTML Cloud SDK for Python を使用して PSD から JPG への変換を確実に実行できるようになりました。サンプルコード、REST cURL コマンド、ベストプラクティスのヒントが揃っているので、単一ファイルの処理でも大量バッチの自動化でも、この機能をアプリケーションに統合するために必要なすべてが手に入ります。製品ページの価格詳細を確認し、temporary license page から評価目的の一時ライセンスを取得してから本番環境へ移行してください。
よくある質問
PythonでのPSDからJPGへの変換は大きなファイルをどのように処理しますか？
SDKはファイルをクラウドにストリーミングするため、巨大なPSDアセットでもファイル全体をメモリに読み込むことなく処理されます。遅延が発生した場合は、クライアントのタイムアウトを調整してください。
多くのPSDファイルを自動的に一括変換できますか？
はい、変換ロジックをループでラップするか、Python の concurrent.futures を使用して複数の変換を並列に実行し、Python で PSD から JPG への変換を完全に自動化できます。
最高の画像品質を得るための設定は何ですか？
jpeg_quality を 90‑95 に設定し、optimize_image を有効にします。この組み合わせにより、ファイルサイズを適度に保ちつつ高品質な JPG 出力が得られます。
Aspose.HTML を使用した画像変換のさらに多くの例はどこで見つけられますか？
追加のシナリオについては、Aspose.HTML Cloud SDK for Python ドキュメント と関連するブログ記事をご覧ください。