Builtin Template とは?
Builtin Template は、API2 に保存されている、Transloadit が保守するバージョン管理された Template です。builtin/encode-hls-video@latest などの builtin/ スラッグで参照されます。
Builtin Template の仕組み
Assembly リクエストでは、同等のカスタム Template を含めたり所有したりする代わりに、プラットフォームが提供する処理グラフを指定できます。サービスは Builtin Template の識別子とバージョンを解決し、呼び出し元の入力とサポート対象のパラメーターを使って、保守されている処理シーケンスを実行します。これにより、ワークフローの保守はプラットフォーム側が担いますが、本番環境の連携では、テスト、再現性、管理された段階的な展開のためにバージョン選択が引き続き重要です。
要点
- Builtin Template の識別子は
builtin/名前空間に属します。@の後に続く接尾辞は、アップロードされたファイル名の一部ではなく、リリースエイリアスまたはバージョンを選択するものです。 @latestの参照先は意図的に変更可能なため、同一のクライアントコードでも、後で保守・更新されたグラフに解決される場合があります。バージョンを固定すると、依存するワークフローを安定させられます。- 組み込みグラフが定義するのは処理手順であり、呼び出し元のメディアそのものではありません。Assembly の作成時には、そのワークフローに必要な有効な入力とパラメーターを引き続き指定する必要があります。
Builtin Template が重要になる場面
保守されているワークフローが必要な処理手順に合う場合は、Builtin Template を参照してください。@latest には後の変更が反映される可能性があるため、再現性が重要な場合は特定のバージョンに固定してください。