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 への移行

処理結果ファイルの保存

Assembly Status JSON の例

はじめてのアプリで画像をリサイズすると、crop_thumbed Step が 1500x500 画像を生成します。次の Assembly Status JSON の抜粋は、その結果の識別と保存に必要なフィールドを示した例です。ほかのステータスフィールドは省略しています。実際のレスポンスでは、ID や URL は例と異なります。

{
  "assembly_id": "7828446e5acd4aa996dce3455ec914e9",
  "ok": "ASSEMBLY_COMPLETED",
  "uploads": [
    {
      "id": "a30bd0776e7f4ac3817b056d102e8219",
      "name": "joe-gardner-149699.jpg",
      "ssl_url": "https://temporary-files.example/upload.jpg"
    }
  ],
  "results": {
    "crop_thumbed": [
      {
        "id": "b8d12f6c517541ca86bf50c537cedb27",
        "original_id": "a30bd0776e7f4ac3817b056d102e8219",
        "name": "joe-gardner-149699.jpg",
        "ssl_url": "https://temporary-files.example/resized.jpg",
        "meta": {
          "width": 1500,
          "height": 500
        }
      }
    ]
  }
}

このように、Transloadit は次のファイルの最終的な保存先とメタデータを提供します。

  • アップロードされたすべてのファイル:uploads キー内
  • 生成されたすべての処理結果ファイル:results キー内

各ファイルオブジェクトには、メタデータと、結果を指す ssl_url が含まれます。エクスポート用 Robot を使用した場合、これらの保存先は S3 バケットなどの指定したストレージになります。それ以外の場合は一時 URL となり、24 時間後に削除されます。

警告

一時 URL は、自分のストレージにファイルを一度ダウンロードするためだけに使用してください。エンドユーザーと共有したり、本番環境で使用したりしないでください。重要な利用制限については、一時ストレージの制限事項を参照してください。

組み込み方に応じて、次のいずれかの方法を選べます。

  • リクエストの発行元で、ローカルに結果を処理する
  • 結果をフォームに追加してバックエンドに送信する⁠
  • (Async Mode の場合)Transloadit から Assembly Status JSON を notify_url に送信し、それを使ってデータベースにエントリを保存する

設定と署名検証については、Webhooks API ドキュメントを参照してください。アプリでペイロードを使用する前に、各 Notification を検証してください。

エンドユーザーへの処理結果ファイルの表示

ファイルを永続ストレージに保存し、アプリで役立つメタデータをデータベースに保存したら、ユーザーにファイルを配信できます。切り抜いた画像を表示するには、以下のプレースホルダー URL を、自分のストレージ内の URL に置き換えてください。

<img
  alt="Resized uploaded image"
  src="https://your-storage.example/resized.jpg"
/>

動画を扱う場合は、HLS.js⁠、Plyr⁠、indigo-player⁠ などのプレーヤーを検討できます。これらは HTTP ライブストリーミングと MPEG-DASH にも対応しています。

ファイル処理結果の保存時に順序に依存しないこと

エンコードが完了し、Transloadit が結果の URL または Assembly Notification URL に POST する際、結果が期待どおりの順序で並んでいるとは限りません。結果の順序に依存しないでください。

たとえば、🤖/image/resize を使う Step が Template 内に 2 つあり、どちらも use で :original ステップを参照しているとします。設定は次のようになります。

{
  "steps": {
    "high": {
      "use": ":original",
      "robot": "/image/resize",
      "width": 500,
      "height": 500
    },
    "low": {
      "use": ":original",
      "robot": "/image/resize",
      "width": 200,
      "height": 200
    }
  }
}

この Template で写真を 30 枚アップロードすると、生成される Assembly JSON には、"results" -> "high" と "results" -> "low" という 2 つの結果配列が含まれます。ただし、配列内の画像の順序は同じではありません。"high" の最初の結果が、15 番目にアップロードした写真から生成されたものである一方、"low" 配列の最初の結果は、10 番目にアップロードした写真から生成されたものかもしれません。

エンコード結果を元のアップロードに対応付ける必要がある場合(おそらく必要になるはずです)は、id プロパティ("uploads" 配列の各エントリ内)と、各結果配列のエントリにある original_id プロパティを照合してください。

アップロードされた元ファイルの保存

エンコード後の処理結果ファイルだけでなく、ユーザーがアップロードした元ファイルも保存しておくと、要件の変更に合わせて、後から別の形式に再エンコードできます。保存しなければ、元ファイルは永久に失われます。ユーザーに再アップロードを依頼するのは、現実的でない場合が多いためです。

メタデータの保存

上記に加え、Assembly は一時的なものである点にも注意してください。Transloadit は 90 日後にレコードを削除します。含まれるメタデータを保持したい場合は、自分のデータストアにインポートしてください。

前のページ ← はじめてのアプリ次のページ Assembly Instructions →
サポートに問い合わせる
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)日本語