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

Template

Template は、受信したファイルの処理方法を定義する設定です。

Assembly Instructionsは、リクエストごとに直接送信することも、Template に保存して、リクエスト内でその template_id を参照することもできます。

Builtin Template

Transloadit では、当社が保守し、バージョン管理するTemplateも提供しています。この Builtin Template は、一般的な変換処理をすぐに始められる、安定したひな形として役立ちます。

利用可能な組み込みの Template と、API で一覧を取得する方法については、Builtin Templateをご覧ください。

処理設定を直接送信すると、すばやくプロトタイプを作成できますが、Template に保存すると次の利点があります。

  1. エンコードのリクエストごとに、機密データや実装の詳細を送信せずに済みます。特にブラウザーと連携する場合に役立ちます。
  2. "allow_steps_override": false と組み合わせると、処理設定の改ざんを防止できます。
  3. Assembly Notificationと組み合わせると、Assembly Replayを有効にできます。
  4. Transloadit をアプリに組み込んでいる場合は、デプロイしたり、App Store での新バージョンの公開を待ったりせずに、エンコード設定を変更できます。

Template の作成方法

  1. アカウントで Template を作成します。
  2. 後から人が識別できるように、Template に名前を付けます。
  3. Template のAssembly Instructionsを JSON で指定します。一覧からサンプルを選択する、ウィザードで処理設定を生成する、既存の Template を複製する、最初から作成する、といった方法があります。
  4. 保存します。

Template を保存すると、作成した Template のページが表示されます。ページ上部には、4b62ee4dbb38455d96fe13d972ec3211 などの Template の ID が表示されます。この ID をコピーして連携コードの template_id に貼り付けるか、Template Editorの下部にある、この ID を含むサンプルを参照できます。

補足

Template Editorには、アップロードフォームを備えたテスト領域もあります。連携コードを更新せずに、ブラウザー上で直接 Template をテストできます(保存する必要もありません)。

実行時の Template の上書き

相互に排他的に見えるかもしれませんが、params 内には template_id と steps の両方を指定でき、実行時に Template の動作を変更できます。実際には、params 内のプロパティは、allow_steps_override を除き、template_id で読み込まれた Template に再帰的にマージされ、上書きされます。

例として、アップロードを受け付け、iPad で適切に再生できるように動画をエンコードし、結果を S3 に保存する次の Template を見てみましょう。

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "encoded": {
      "use": ":original",
      "robot": "/video/encode",
      "preset": "ipad-high"
    },
    "exported": {
      "use": "encoded",
      "robot": "/s3/store",
      "credentials": "YOUR_S3_CREDENTIALS",
      "bucket": "main-bucket"
    }
  }
}

Assemblyの作成時に、たとえば steps プロパティを追加すると、実行時に Template の動作を調整できます。

{
  "template_id": "4b62ee4dbb38455d96fe13d972ec3211",
  "steps": {
    "exported": {
      "bucket": "another-bucket"
    }
  }
}

Transloadit はこれをマージして、次の Assembly Instructionsを作成します。

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "encoded": {
      "use": ":original",
      "robot": "/video/encode",
      "preset": "ipad-high"
    },
    "exported": {
      "use": "encoded",
      "robot": "/s3/store",
      "credentials": "YOUR_S3_CREDENTIALS",
      "bucket": "another-bucket"
    }
  }
}

このように、bucket の値が "main-bucket" から "another-bucket" に変わりました。信頼できる環境では、便利で強力な機能です。

それ以外の環境では、ブラウザーから動作を変更できないように、Stepの上書きを禁止したい場合があります。その場合は、保存済みの Template 内で、次のように allow_steps_override を false に設定します。

{
  "allow_steps_override": false,
  "steps": {
    // …
  },
}

これで、追加の steps が指定されたかどうかにかかわらず、main-bucket だけが使用されます。

Template のオプション

steps と allow_steps_override のほかにも、Assemblyの動作を制御するオプションがあります。

ほとんどのオプションは Template を使用しない場合にも設定できるため、新しい Assembly を作成するための API ドキュメントで説明しています。ただし、ブラウザーなどの信頼できない環境に Transloadit を組み込むと、悪意のある利用者が簡単にこれらを変更できてしまいます。そのため、信頼できない環境で Template のパラメーターを動的に変更できるようにするには、Signature Authenticationの使用を検討してください。

前のページ ← 動的評価次のページ Webhook →
サポートに問い合わせる
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)日本語