Python と Transloadit
Transloadit REST API 用の継続的にメンテナンスされている Python クライアント、pytransloadit でローカルファイルをアップロードして処理します。
実行可能な処理設定
連携を構築
このスクリプトは、コマンドラインから一つのファイルパスを読み取り、そのファイルをアップロードして画像のサイズを変更し、処理の完了を待って Assembly ID を出力します。
- 仮想環境を作成し、pytransloadit をインストールしてください。
- プロセスの環境変数に TRANSLOADIT_KEY と TRANSLOADIT_SECRET を設定してください。
- python process_image.py path/to/photo.jpg を実行してください。
インストール
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade 'pytransloadit>=2,<3'process_image.py
import os
import sys
from transloadit import client
transloadit = client.Transloadit(
os.environ['TRANSLOADIT_KEY'],
os.environ['TRANSLOADIT_SECRET'],
)
assembly = transloadit.new_assembly()
with open(sys.argv[1], 'rb') as input_file:
assembly.add_file(input_file)
assembly.add_step('resize', '/image/resize', {
'width': 1200,
'height': 1200,
'resize_strategy': 'fit',
})
response = assembly.create(retries=5, wait=True)
if response.data.get('error'):
raise RuntimeError('Media processing failed')
print(response.data['assembly_id'])認証
- サーバーの環境変数から Transloadit の Auth Key と Auth Secret を読み取り、両方を公式 Python SDK に渡してください。
- シークレットを指定すると、SDK がリクエストに署名します。どちらの認証情報も、ソース管理には絶対にコミットしないでください。
- アプリケーションのユーザーがファイルを選択する場合は、固定の Template を使用するか、Assembly を作成する前に動的な Step をすべて検証してください。
制限事項と運用上の注意点
- wait=True は Assembly が完了するまでプロセスをブロックします。ウェブワーカーや長時間実行するメディア処理ジョブでは、Assembly ID を保存し、非同期で完了を確認してください。
- バージョン 2 には Python 3.12 以降が必要です。インストールコマンドでは、Python 3.9 から 3.11 で古い 1.x SDK が通知なくインストールされないよう、バージョン 2 を明示的に選択します。
- retries オプションは、再開可能なアップロードと、レート制限を受けた Assemblyの作成またはステータスポーリングの再試行回数を制限します。アプリケーションレベルの冪等性は提供しません。wait=True の場合、ポーリングの再試行回数を使い切ると AssemblyPollingError が発生しますが、Assemblyはまだ実行中の可能性があります。むやみにジョブを再送信せず、例外に含まれる復旧用の詳細情報を使って既存の Assemblyを追跡してください。
その他の連携