Transloadit
料金
  • ファイルアップロード
  • ファイルインポート
  • バッチ処理
  • 動画エンコーディング
  • 音声エンコーディング
  • 画像処理
  • ドキュメント処理
  • 人工知能
  • ファイルフィルタリングとセキュリティ
  • メディアカタログ化
  • ファイル圧縮
  • コード評価
  • ファイルエクスポート
  • Smart CDN
  • すべてのサービスを表示
  • 連携機能を見る
  • 実行可能なデモを試す (English)
  • Uppy
  • TransloaditKit
  • Android 用 SDK
  • Node.js 用 SDK
  • Next.js 用ビューアー
  • Python 用 SDK
  • Ruby 用 SDK
  • Go 用 SDK
  • Java 用 SDK
  • PHP 用 SDK
  • Zapier
  • MCP サーバー
  • Transloadit CLI
  • Terraform
  • 基本事項
  • ベストプラクティス
  • よくある質問
  • Robot
  • API
  • 形式
  • 初めてのアプリ開発
  • 会社概要
  • 比較
  • オープンソース
  • お客様の声
  • 採用情報 (English)
  • セキュリティ
  • 記事
  • 開発者ニュース (English)
  • 開発のヒント
  • プレス
  • 研究 (English)
  • 導入事例
  • ソリューション
  • ガイド (English)
  • 用語集
  • 法務 (English)
  • ツール
  • 世界中の数百万人に教育を届ける Coursera を支援
  • Transloadit サポート
  • オープンソースサポート
  • サービスレベル契約 (English)
  • エンジニアによるデモを予約 (English)
基本事項Robotよくある質問API形式ベストプラクティス
はじめに
  • 概要
  • はじめてのアプリ
  • 処理結果ファイルの保存
トピック
  • Assembly Instructions
  • Assembly Variable
  • 動的評価
  • Template
  • Webhook
  • サードパーティ認証情報
  • Builtin Template
  • リサイズ方式
  • Assembly Execution Progress
  • Workspace
  • AI エージェント
  • use パラメーターの高度な設定
  • ignore_errors パラメーター
ソフトウェア開発キット
  • 概要
  • Android SDK
  • ブラウザー
  • Convex
  • cURL
  • Go SDK
  • Java SDK
  • MCP Server
  • マルチパートフォーム
  • Node.js SDK
  • Next.js 向け Viewer
  • PHP SDK
  • Python SDK
  • Ruby SDK
  • Terraform
  • TransloaditKit
  • Zapier 連携
移行
  • 移行ガイド
  • Cloudinary から Transloadit への移行
  • Uploadcare から Transloadit への移行
  • Mux から Transloadit への移行
  • Filestack から Transloadit への移行

Python SDK

transloadit/python-sdk⁠

インストール

SDK は PyPI で pytransloadit⁠として公開されています。バージョン 2 には Python 3.12 以降が必要です。

python -m pip install --upgrade 'pytransloadit>=2,<3'

このコマンドは Python 3.9 から 3.11 では失敗します。これらの環境では、単に pip install pytransloadit を実行すると、1.x の最新リリースである 1.0.4 がインストールされます。明示的に 1.x を使い続けるには、バージョン 2 未満に固定します。

python -m pip install 'pytransloadit<2'

使い方

import os

from transloadit import client

tl = client.Transloadit(os.environ['TRANSLOADIT_KEY'], os.environ['TRANSLOADIT_SECRET'])
assembly = tl.new_assembly()
assembly.add_step('resize', '/image/resize', {'width': 70, 'height': 70})
with open('PATH/TO/FILE.jpg', 'rb') as upload:
    assembly.add_file(upload)
    assembly_response = assembly.create(retries=5, wait=True)

if 'error' in assembly_response.data:
    raise RuntimeError(assembly_response.data['error'])
print(assembly_response.data['assembly_id'])

create(wait=True) は Assembly が完了すると戻ります。API エラーは例外として送出されず、レスポンスに含まれます。そのため、この例では結果を使う前に error キーの有無を確認しています。

非同期での使い方

AsyncTransloadit は、FastAPI、aiohttp などの非同期フレームワークで構築したアプリ向けの asyncio クライアントです。aiohttp 経由で API リクエストを送信し、asyncio.sleep で Assembly の状態をポーリングするため、Assembly の完了を待っている間もイベントループをブロックしません。

import asyncio
import os

from transloadit.async_client import AsyncTransloadit


async def main():
    key = os.environ['TRANSLOADIT_KEY']
    secret = os.environ['TRANSLOADIT_SECRET']
    async with AsyncTransloadit(key, secret) as tl:
        assembly = tl.new_assembly()
        assembly.add_step('resize', '/image/resize', {'width': 70, 'height': 70})
        with open('PATH/TO/FILE.jpg', 'rb') as upload:
            assembly.add_file(upload)
            response = await assembly.create(wait=True, resumable=False)
    if 'error' in response.data:
        raise RuntimeError(response.data['error'])
    print(response.data['assembly_id'])


asyncio.run(main())

非同期クライアントは同期クライアントと同様に、Assembly、Template、月次請求、Smart CDN の URL 署名に対応しています。ネットワークリクエストを行うメソッドには await を使います。new_assembly()、new_template()、get_signed_smart_cdn_url() は同期のままです。await する create() の呼び出しが戻るまで、ファイルを開いたままにしてください。

クライアントは async with と組み合わせて使うか、使い終わったら await tl.aclose() を呼び出してください。session= で独自の aiohttp セッションを渡せます。create() でデフォルトとなる再開可能なアップロードは、ワーカースレッド内で tus を使って転送するため、大きなファイルのアップロード中もイベントループの応答性を維持します。ただし、この転送には指定した aiohttp セッションは使われません。転送のプロキシと TLS の設定は、Requests の環境設定で行ってください。

1.x からのアップグレード

1.x 向けに書かれた同期コードは、そのまま動作します。from transloadit import client とそのメソッドは、バージョン 2 でも変更されていません。アップグレード前に、次の点を確認してください。

  • Python 3.12 以降。 まず開発、CI、デプロイ環境のインタープリターをアップグレードしてください。
  • 依存関係の下限。 バージョン 2 には requests>=2.33,<3 と urllib3>=2.7,<3 が必要です。制約設定内の古いバージョン固定を緩和し、ロックファイルを再生成してください。
  • リダイレクト。 HTTP リダイレクトは追跡されず、そのまま返されます。
  • 入力検証。 無効なサービス URL や空の Template ID を指定すると、ValueError が送出されます。
  • Template。 template オプションと add_step() を組み合わせる場合、template の値は JSON 文字列ではなく dict として渡してください。
  • レスポンス。 JSON 以外のレスポンスでは、Response.data にテキストまたはバイト列が格納されます。本文が空の場合は空文字列になります。
  • ポーリング。 wait=True では、レート制限された状態確認の再試行回数を使い切ると、AssemblyPollingError が送出されます。Assembly はまだ実行中の可能性があります。エラーの assembly_url を使って、再度ポーリングするかキャンセルしてください。
  • Assembly URL。 状態確認とキャンセルのリクエストは、信頼できる Assembly URL にのみ送信されます。デフォルトのクライアントは、ほかのホストを拒否します。
  • Smart CDN。 ブール値のパラメーターは、当社の Node.js リファレンス実装と同じく、true と false として署名されます。Workspace のスラッグは DNS で安全に使える必要があり、auth_key、exp、sig は予約済みのクエリキーです。

アップグレードに関する詳細は、README⁠ と変更履歴⁠を参照してください。

サンプル

そのまま動作する同期と非同期のサンプルは、examples/⁠を参照してください。

ドキュメント

両クライアントの完全な API リファレンスは、Read the Docs⁠を参照してください。ソースコードと課題トラッカーは GitHub⁠、リリースは PyPI⁠で公開しています。

前のページ ← PHP SDK次のページ Ruby SDK →
サポートに問い合わせる
Transloadit稼働状況を確認中…

製品

  • サービス
  • 料金
  • デモ EN (English)
  • ツール
  • セキュリティ
  • サポート

会社

  • 会社概要/プレス
  • ブログ/採用情報 EN (English)
  • 比較/コンプライアンス対応表
  • 研究 EN (English)
  • オープンソース
  • ソリューション
  • ウェブの先駆者たち

ドキュメント

  • はじめに
  • トランスコーディング
  • よくある質問
  • API
  • ガイド EN (English)/開発のヒント
  • 対応フォーマット

その他

  • プラットフォームの稼働状況⁠
  • コミュニティフォーラム⁠
  • Uppy
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Transloadit®、tus®、Uppy® は、米国における Transloadit-II GmbH の登録商標です。

プライバシー EN (English)利用規約 EN (English)運営者情報 EN (English)商標 EN (English)DMCA ポリシー EN (English)
EnglishDeutschEspañolFrançaisPortuguês (Brasil)日本語