▤ 動画容量ナビ

動画の容量と保存 · 参考資料確認日 2026年10月30日

Transloaditの200 GB対応とupload全体・file単位の上限を分ける

Transloaditで大きなfileを扱うときは、platformが扱える最大sizeと、自分のupload全体・file単位・件数に設ける上限を分けて決めます。max_sizeをper-file ceilingと誤解しないことが重要です。

HTTP importは最大200 GB、applicationの許容値とは別

TransloaditのHTTP importはfile sizeを最大200 GBまでsupportすると案内しています。これはHTTP importの上限であり、applicationが常に200 GBまで受け付ける必要があるという意味ではありません。

また、200 GB以内ならすべてのdownstream Robotがあらゆるformatとsizeを処理できるとは限りません。使うRobot固有の入力条件は別に確認します。

max_sizeはcombined upload全体、per-file判定は/file/filter

Assembly作成requestのparams.auth.max_sizeは、bytesで指定するAssembly全体のexpected upload sizeの上限で、保存済みTemplateにも設定できます。multipart request bodyのoverheadも含み、個々のfileだけに適用するceilingではありません。合計が設定値を超えると、そのfileだけを除外するのではなく、Assembly全体が停止します。Template Credentialは別機能で、外部サービスの認証情報を保存するものであり、このsize上限の設定先ではありません。

fileごとにaccept、decline、別Stepへの分岐をしたい場合は/file/filterを使います。file数を制限する場合はauth.max_number_of_filesを別に設定します。auth.max_size、/file/filter、auth.max_number_of_filesは、それぞれ全体size、file単位の条件、件数という異なるunitを受け持ちます。

auth.max_sizeは、resumable uploadを転送開始前に必ず拒否する仕組みではありません。deferred uploadでは開始時にsizeが不明で、判定される時点ではbytesが転送済みのことがあります。

全体size・file条件・件数を別々に設定して境界を試す

combined upload全体に上限を設けたいなら、multipartのoverheadも見込んだbytes値をAssembly requestのparams.auth.max_sizeまたは保存済みTemplateに設定します。個別fileのsizeやtypeで判定する条件は/file/filterへ、件数の上限はauth.max_number_of_filesへ分けて設定してください。

設定後は合計sizeの直下と直上、個別条件に合うfileと外れるfileの混在、件数の直下と直上を確認します。resumable uploadでは転送開始前に拒否されるとは限らないため、deferred uploadを使う場合は判定のタイミングも確認してください。どのcontrolで止まったかを記録し、続くRobotについてはそのRobot固有のformat・size条件も確認します。

参考資料

  • Transloadit HTTP import

    https://transloadit.com/docs/robots/http-import/

    確認日:2026-10-30

    HTTP import はfile size最大200 GB。下流Robotの処理可否は別。

  • Transloadit Create an Assembly API

    https://transloadit.com/docs/api/assemblies-post/

    確認日:2026-10-30

    params.auth.max_size はmultipart overheadを含むAssembly全体のexpected upload bytesで、保存済みTemplateにも設定可。超過はAssembly全体を停止。resumable uploadを転送開始前に必ず拒否するわけではなく、deferred時は転送後に判定され得る。auth.max_number_of_filesは別設定。

  • Transloadit file filter

    https://transloadit.com/docs/robots/file-filter/

    確認日:2026-10-30

    /file/filter はfile metadataのsize/typeなどでfileごとにaccept/decline/分岐できる。

  • Transloadit Create a Template Credential API

    https://transloadit.com/docs/api/template-credentials-post/

    確認日:2026-10-30

    Template Credentialsは外部サービスの認証情報を保存する別のAPI資源であり、params.auth.max_sizeの設定先ではない。