Builtin Templates : transformations stables et versionnées
Vous souhaitez parfois partir d’un Template solide et éprouvé
plutôt que d’en créer un de toutes pièces. Aujourd’hui, nous annonçons les Builtin Templates :
des Templates versionnés et maintenus par Transloadit,
que vous pouvez référencer via template_id comme tout autre
Template.
Les Builtin Templates sont conçus pour les transformations courantes et servent de briques rapidement utilisables. Ils sont stables et versionnés, et vous pouvez figer une version précise lorsque votre déploiement nécessite un contrôle des changements.
Que sont les Builtin Templates ?
Les Builtin Templates résident dans API2 et sont identifiés par des slugs commençant par
builtin/, par exemple :
builtin/encode-hls-video@0.0.1builtin/generate-image@0.0.1builtin/generate-video@0.0.1
Vous pouvez les utiliser via template_id :
builtin/<name>renvoie à la dernière version connue.builtin/<name>@latestest un alias explicite de la dernière version connue.builtin/<name>@<version>permet de figer une version précise.
Pourquoi utiliser les Builtin Templates ?
- Partir d’une base éprouvée pour les transformations courantes.
- Garder une intégration légère : inutile de créer un Template pour faire un essai.
- Figer les versions pour obtenir un comportement prévisible, puis mettre à niveau quand vous êtes prêt.
- Les combiner avec vos propres Steps grâce aux surcharges à l’exécution, comme tout autre Template.
Exemple rapide : créer une Assembly avec un Builtin Template
Voici la structure d’une requête d’Assembly utilisant un Builtin Template :
{
"template_id": "builtin/encode-hls-video"
}
Vous pouvez toujours surcharger ou étendre les Steps à l’exécution (par exemple, pour ajouter un Step d’export vers un stockage), comme avec tout autre Template. Pour en savoir plus sur les surcharges, consultez Templates.
Explorer les options disponibles
Nous tenons à jour la liste de référence et les notes d’utilisation dans la documentation :
Si vous souhaitez les voir apparaître dans les listes renvoyées par l’API, vous pouvez les inclure dans
GET /templates avec include_builtin
(consultez la référence du point de terminaison pour plus de détails) :
La suite
Les Builtin Templates couvrent encore un périmètre limité, que nous élargirons en fonction des usages réels. Si vous exécutez régulièrement une transformation et pensez qu’elle devrait devenir un Builtin Template, faites-le-nous savoir.
Si vous n’utilisez pas encore de Templates, commencez par là :