# Travel Diary Adventure Promotion Template (video template) > Promote your next travel sale or tour package with our engaging 'Travel Diary' promotion template. Perfect for travel agencies and tour operators. ## Overview - **Page**: https://shotstack.io/studio/templates/travel-diary-adventure-promo-template-v2/ - **Output**: MP4, 1080x1920 (9:16), 25 fps - **Length**: 5s - **Timeline**: 26 clips on 21 tracks; assets: audio, image, luma, rich-text, svg, video - **Render endpoint (sandbox, free, watermarked)**: POST https://api.shotstack.io/edit/stage/render with header `x-api-key` - **Production**: same request against https://api.shotstack.io/edit/v1/render with a v1 key - **Preview in the browser (no account)**: https://shotstack.studio/#json=eyJ0aW1lbGluZSI6eyJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1N1YnRpdGxlfX0iLCJmb250Ijp7ImZhbWlseSI6IkpUVVNqSWcxX2k2dDhrQ0hLbTQ1eFc1cnlnYmk0OWMiLCJzaXplIjozMCwid2VpZ2h0Ijo3MDAsImNvbG9yIjoie3sgQkFDS0dST1VORF9DT0xPUiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJmYWRlSW4iLCJzdHlsZSI6IndvcmQifX0sInN0YXJ0IjowLjIsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjI3NH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifSwid2lkdGgiOjUwMCwiaGVpZ2h0IjoxMDB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiIge3tQbGFjZV80fX0iLCJmb250Ijp7ImZhbWlseSI6IkpUVVNqSWcxX2k2dDhrQ0hLbTQ1eFc1cnlnYmk0OWMiLCJzaXplIjoyNCwid2VpZ2h0Ijo3MDAsImNvbG9yIjoie3sgRk9OVF9DT0xPUl8yIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifX0sInN0YXJ0IjowLjY1LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MC4xMjUsInkiOi0wLjIzMn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6MTB9fSwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifSwid2lkdGgiOjQwMCwiaGVpZ2h0Ijo3Mn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7UGxhY2VfM319IiwiZm9udCI6eyJmYW1pbHkiOiJKVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljIiwic2l6ZSI6MjQsIndlaWdodCI6NzAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn19LCJzdGFydCI6MC41NSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjIzMSwieSI6LTAuMTY1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjotMTJ9fSwidHJhbnNpdGlvbiI6eyJpbiI6ImZhZGUifSwid2lkdGgiOjQwMCwiaGVpZ2h0Ijo3Mn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7UGxhY2VfM319IiwiZm9udCI6eyJmYW1pbHkiOiJKVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljIiwic2l6ZSI6MjQsIndlaWdodCI6NzAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn19LCJzdGFydCI6MC40NSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAuMjA0LCJ5IjowLjAzM30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6OH19LCJ3aWR0aCI6NDAwLCJoZWlnaHQiOjcyfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0IjoiIHt7UGxhY2VfMX19IiwiZm9udCI6eyJmYW1pbHkiOiJKVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljIiwic2l6ZSI6MjQsIndlaWdodCI6NzAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn19LCJzdGFydCI6MC4zNSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjIxMywieSI6MC4wMzh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOi00fX0sIndpZHRoIjo0MDAsImhlaWdodCI6NzJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWRpYXJ5LWFkdmVudHVyZS1wcm9tby10ZW1wbGF0ZS9lNWUyYjFjZi0zMWZlLTQ5MzktYjE1ZC1jZDJhM2ExNGQ0MWYvc291cmNlLnBuZyJ9LCJzdGFydCI6MC43LCJsZW5ndGgiOjQuM30seyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoiaW1hZ2UiLCJzcmMiOiJ7eyBGbGFnIH19In0sInN0YXJ0IjowLjcsInNjYWxlIjoxLCJvZmZzZXQiOnsieCI6LTAuMjcxOTQ0NTc0NTM5MTQ2NTYsInkiOi0wLjI2NTkxNzk4NTg2NTcwMTE1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiZmFkZSJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjM3NSwiaGVpZ2h0IjozODd9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjQsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFZJREVPXzQgfX0iLCJ2b2x1bWUiOjF9LCJzdGFydCI6MC42LCJzY2FsZSI6MSwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6MTB9fSwib2Zmc2V0Ijp7IngiOjAuMTU0NTk0MTA1MDEyMjMyMTQsInkiOi0wLjE0MjI0NDAxOTYzMDE1NjMyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiY2Fyb3VzZWxMZWZ0In0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6Mzk4LCJoZWlnaHQiOjMwMX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDQ0MiAzNzBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI0NDJcIiBoZWlnaHQ9XCIzNzBcIiBmaWxsPVwie3sgRk9OVF9DT0xPUl8xIH19XCIvPjwvc3ZnPiJ9LCJzdGFydCI6MC42LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MC4xNTEsInkiOi0wLjE1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjoxMH19LCJ0cmFuc2l0aW9uIjp7ImluIjoiY2Fyb3VzZWxMZWZ0In0sIndpZHRoIjo0NDIsImhlaWdodCI6MzcwfV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NC41LCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBWSURFT18zIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjAuNSwic2NhbGUiOjEsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOi0xMn19LCJvZmZzZXQiOnsieCI6LTAuMjYwMjQwMTg5NzA2NDYzMzQsInkiOi0wLjA3NTk2ODg5NTMyMjg2MDMzfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoiY2Fyb3VzZWxSaWdodCJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjQwNiwiaGVpZ2h0IjozMDh9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCA0NDIgMzcwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiNDQyXCIgaGVpZ2h0PVwiMzcwXCIgZmlsbD1cInt7IEZPTlRfQ09MT1JfMSB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjAuNSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjI1OCwieSI6LTAuMDgyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjotMTJ9fSwidHJhbnNpdGlvbiI6eyJpbiI6ImNhcm91c2VsUmlnaHQifSwid2lkdGgiOjQ0MiwiaGVpZ2h0IjozNzB9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjYsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFZJREVPXzIgfX0iLCJ2b2x1bWUiOjF9LCJzdGFydCI6MC40LCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAuMjQwNzQwNzQwNzQwNzQwNywieSI6MC4xMjV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOjh9fSwiZml0IjoiY29udGFpbiIsIndpZHRoIjozOTksImhlaWdodCI6MzAyfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgNDQyIDM3MFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjQ0MlwiIGhlaWdodD1cIjM3MFwiIGZpbGw9XCJ7eyBGT05UX0NPTE9SXzEgfX1cIi8-PC9zdmc-In0sInN0YXJ0IjowLjQsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjI0LCJ5IjowLjExNn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNmb3JtIjp7InJvdGF0ZSI6eyJhbmdsZSI6OH19LCJ3aWR0aCI6NDQyLCJoZWlnaHQiOjM3MH1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjQuNywiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgVklERU9fMSB9fSIsInZvbHVtZSI6MX0sInN0YXJ0IjowLjMsInNjYWxlIjoxLCJvZmZzZXQiOnsieCI6LTAuMjE1NTgyMDA0OTY2ODI0MzQsInkiOjAuMTMyNzE0Mjg3MjI4MTkzfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjotNH19LCJ0cmFuc2l0aW9uIjp7ImluIjoiY2Fyb3VzZWxSaWdodCJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjQwMywiaGVpZ2h0IjozMDZ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCA0NDIgMzcwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiNDQyXCIgaGVpZ2h0PVwiMzcwXCIgZmlsbD1cInt7IEZPTlRfQ09MT1JfMSB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjAuMywibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjIxNSwieSI6MC4xMjV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zZm9ybSI6eyJyb3RhdGUiOnsiYW5nbGUiOi00fX0sInRyYW5zaXRpb24iOnsiaW4iOiJjYXJvdXNlbFJpZ2h0In0sIndpZHRoIjo0NDIsImhlaWdodCI6MzcwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tUaXRsZX19IiwiZm9udCI6eyJmYW1pbHkiOiJCbG93Iiwic2l6ZSI6MTUwLCJ3ZWlnaHQiOjcwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzEgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9fSwic3RhcnQiOjAsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLCJ5IjowLjM5N30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlRG93biJ9LCJ3aWR0aCI6MTAwMCwiaGVpZ2h0IjoyNTB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWRpYXJ5LWFkdmVudHVyZS1wcm9tby10ZW1wbGF0ZS80NmNjY2ExOC0zOTNmLTQ4NzQtODdkOC04ZmYxMDA0MTQxZTcvc291cmNlLnBuZyJ9LCJzdGFydCI6MC44LCJsZW5ndGgiOjQuMn0seyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDQ0MSA1MDBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI0NDFcIiBoZWlnaHQ9XCI1MDBcIiBmaWxsPVwiI2ZmZmZmZlwiLz48L3N2Zz4ifSwic3RhcnQiOjAuOCwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjM3Mn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6ImNhcm91c2VsVXAifSwid2lkdGgiOjQ0MSwiaGVpZ2h0Ijo1MDB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiIge3tDVEF9fSIsImZvbnQiOnsiZmFtaWx5IjoiSlRVU2pJZzFfaTZ0OGtDSEttNDV4VzVyeWdiaTQ5YyIsInNpemUiOjQ0LCJ3ZWlnaHQiOjcwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SXzIgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJiYWNrZ3JvdW5kIjp7ImNvbG9yIjoie3sgU0hBUEVfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjEsImJvcmRlclJhZGl1cyI6MTF9LCJwYWRkaW5nIjoxNX0sInN0YXJ0IjowLjgsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4zNzJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJjYXJvdXNlbFVwIn0sIndpZHRoIjo0MjYsImhlaWdodCI6OTN9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWRpYXJ5LWFkdmVudHVyZS1wcm9tby10ZW1wbGF0ZS9iMDEzNzI3Ny1mNTM1LTRjZWItOTU4NS1kZjAxYmVmYmIwZWIvc291cmNlLnBuZyJ9LCJzdGFydCI6MC4xLCJsZW5ndGgiOjQuOX0seyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDkwMyA4MjJcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI5MDNcIiBoZWlnaHQ9XCI4MjJcIiBmaWxsPVwie3sgU0hBUEVfQ09MT1JfMSB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjAuMSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjE0Mn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlVXAifSwid2lkdGgiOjkwMywiaGVpZ2h0Ijo4MjJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWRpYXJ5LWFkdmVudHVyZS1wcm9tby10ZW1wbGF0ZS85NjkwOWYxMy1kMzIxLTRhM2YtYTZlMy05N2I1NzI3MDc2ODgvc291cmNlLnBuZyJ9LCJzdGFydCI6MC4xLCJsZW5ndGgiOjQuOX0seyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDkwMyA4MjJcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI5MDNcIiBoZWlnaHQ9XCI4MjJcIiBmaWxsPVwie3sgU0hBUEVfQ09MT1JfMSB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjAuMSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMTQ4fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVVcCJ9LCJ3aWR0aCI6OTAzLCJoZWlnaHQiOjgyMn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDEwODAgMTkyMFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjEwODBcIiBoZWlnaHQ9XCIxOTIwXCIgZmlsbD1cInt7IEJBQ0tHUk9VTkRfQ09MT1IgfX1cIi8-PC9zdmc-In0sInN0YXJ0IjowLCJsZW5ndGgiOjUsInBvc2l0aW9uIjoiY2VudGVyIiwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZGlhcnktYWR2ZW50dXJlLXByb21vLXRlbXBsYXRlL2EyMTdmNjZiLWY5MTEtNGMwNC05MDI5LTQyOWNhYmY1MmU1Yy9zb3VyY2UubXA0In0sInN0YXJ0IjowLCJsZW5ndGgiOjV9XX1dLCJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvOWVmYTRlYjItOGEyMC00ZjkwLWE3M2UtZGQ4MWFjMmMxODBlL3NvdXJjZS50dGYifSx7InNyYyI6Imh0dHBzOi8vZm9udHMuZ3N0YXRpYy5jb20vcy9tb250c2VycmF0L3YzMS9KVFVTaklnMV9pNnQ4a0NIS200NXhXNXJ5Z2JpNDljLnR0ZiJ9LHsic3JjIjoiaHR0cHM6Ly9zaG90c3RhY2staW5nZXN0LWFwaS12MS1zb3VyY2VzLnMzLmFwLXNvdXRoZWFzdC0yLmFtYXpvbmF3cy5jb20vcHQ2eHloNjl5ai96enowMWt5ai05ZGgwcS16amo1dC1qZzBmMy1rZXltczgvc291cmNlLnR0ZiJ9XX0sIm91dHB1dCI6eyJmb3JtYXQiOiJtcDQiLCJmcHMiOjI1LCJzaXplIjp7IndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjB9LCJkZXN0aW5hdGlvbnMiOlt7InByb3ZpZGVyIjoic2hvdHN0YWNrIn1dfSwibWVyZ2UiOlt7ImZpbmQiOiJUaXRsZSIsInJlcGxhY2UiOiJUUkFWRUwgRElBUlkifSx7ImZpbmQiOiJTdWJ0aXRsZSIsInJlcGxhY2UiOiJTSE9XIE9ORTogQSBUT1VSIElOIE5FVyBaRUFMQU5EIn0seyJmaW5kIjoiUGxhY2VfMSIsInJlcGxhY2UiOiJBdWNrbGFuZCJ9LHsiZmluZCI6IlBsYWNlXzIiLCJyZXBsYWNlIjoiUXVlZW5zdG93biJ9LHsiZmluZCI6IlBsYWNlXzMiLCJyZXBsYWNlIjoiUm90b3J1YSJ9LHsiZmluZCI6IlBsYWNlXzQiLCJyZXBsYWNlIjoiQ2hyaXN0Y2h1cmNoIn0seyJmaW5kIjoiQ1RBIiwicmVwbGFjZSI6IlZJRVcgVE9EQVkifSx7ImZpbmQiOiJGT05UX0NPTE9SXzEiLCJyZXBsYWNlIjoiI2ZmZmZmZiJ9LHsiZmluZCI6IkJBQ0tHUk9VTkRfQ09MT1IiLCJyZXBsYWNlIjoiIzAwNmZlNiJ9LHsiZmluZCI6IlNIQVBFX0NPTE9SXzEiLCJyZXBsYWNlIjoiI2RlZGVkZSJ9LHsiZmluZCI6IkZPTlRfQ09MT1JfMiIsInJlcGxhY2UiOiIjMDAwMDAwIn0seyJmaW5kIjoiU0hBUEVfQ09MT1JfMiIsInJlcGxhY2UiOiIjZmZlYTAwIn0seyJmaW5kIjoiVklERU9fMSIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWRpYXJ5LWFkdmVudHVyZS1wcm9tby10ZW1wbGF0ZS9kYWZjMTg4YS1mZGNjLTQxNGUtOGExZi1hYjg5NDg5MDg2ZDYvc291cmNlLm1wNCJ9LHsiZmluZCI6IlZJREVPXzIiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvMjk3OWI4NjktODk4ZS00YTFjLWExZjctMmY3ZTg5ZTc2NzM4L3NvdXJjZS5tcDQifSx7ImZpbmQiOiJWSURFT18zIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby90cmF2ZWwtZGlhcnktYWR2ZW50dXJlLXByb21vLXRlbXBsYXRlLzYyZjlhY2Y5LWIwNTYtNDVlNy1iNzhiLTY0NGM2YTRjOTlhMS9zb3VyY2UubXA0In0seyJmaW5kIjoiVklERU9fNCIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWRpYXJ5LWFkdmVudHVyZS1wcm9tby10ZW1wbGF0ZS8zNDczNTAxOS0wNjUwLTQxMjQtOGEyZC02YzYwMjhjOTk0ZGYvc291cmNlLm1wNCJ9LHsiZmluZCI6IkZsYWciLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3RyYXZlbC1kaWFyeS1hZHZlbnR1cmUtcHJvbW8tdGVtcGxhdGUvMDc3ZWFlNjctMTQzMy00ZjhmLTk2ZmYtNWQ3YWIzNTM1M2ZjL3NvdXJjZS5wbmcifSx7ImZpbmQiOiJBVURJTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdHJhdmVsLWRpYXJ5LWFkdmVudHVyZS1wcm9tby10ZW1wbGF0ZS82YmQ4YTgwOC0xNTFjLTRlNDMtODI2Mi02NDIxNWNiOTM5MWMvc291cmNlLm1wMyJ9XX0 - **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/travel-diary-adventure-promo-template-v2 ## How to use this template as a workflow 1. Render it once with the JSON below to confirm the output. 2. Replace the values that change per row of data (merge fields or asset URLs). 3. Loop over your data (CSV, database, webhook payload) and send one render per row. Add a `callback` URL to the request so Shotstack notifies you when each video is ready instead of polling. 4. To keep the JSON out of your app, store it with the Templates endpoint and render by template ID with a `merge` array: https://shotstack.io/docs/guide/architecting-an-application/templates/ ## Customise This template has merge fields. Send a `merge` array with the request to replace them; do not edit the timeline JSON. | Field | Default | | --- | --- | | `{{ Title }}` | TRAVEL DIARY | | `{{ Subtitle }}` | SHOW ONE: A TOUR IN NEW ZEALAND | | `{{ Place_1 }}` | Auckland | | `{{ Place_2 }}` | Queenstown | | `{{ Place_3 }}` | Rotorua | | `{{ Place_4 }}` | Christchurch | | `{{ CTA }}` | VIEW TODAY | | `{{ FONT_COLOR_1 }}` | #ffffff | | `{{ BACKGROUND_COLOR }}` | #006fe6 | | `{{ SHAPE_COLOR_1 }}` | #dedede | | `{{ FONT_COLOR_2 }}` | #000000 | | `{{ SHAPE_COLOR_2 }}` | #ffea00 | | `{{ VIDEO_1 }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/dafc188a-fdcc-414e-8a1f-ab89489086d6/source.mp4 | | `{{ VIDEO_2 }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/2979b869-898e-4a1c-a1f7-2f7e89e76738/source.mp4 | | `{{ VIDEO_3 }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/62f9acf9-b056-45e7-b78b-644c6a4c99a1/source.mp4 | | `{{ VIDEO_4 }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/34735019-0650-4124-8a2d-6c6028c994df/source.mp4 | | `{{ Flag }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/077eae67-1433-4f8f-96ff-5d7ab35353fc/source.png | | `{{ AUDIO }}` | https://templates.shotstack.io/travel-diary-adventure-promo-template/6bd8a808-151c-4e43-8262-64215cb9391c/source.mp3 | ## Template JSON ```json { "timeline": { "background": "#FFFFFF", "tracks": [ { "clips": [ { "length": "end", "asset": { "type": "audio", "src": "{{ AUDIO }}", "volume": 1 }, "start": 0 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{Subtitle}}", "font": { "family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c", "size": 30, "weight": 700, "color": "{{ BACKGROUND_COLOR }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" }, "animation": { "preset": "fadeIn", "style": "word" } }, "start": 0.2, "length": "end", "offset": { "x": 0, "y": 0.274 }, "position": "center", "transition": { "in": "slideUp" }, "width": 500, "height": 100 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": " {{Place_4}}", "font": { "family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c", "size": 24, "weight": 700, "color": "{{ FONT_COLOR_2 }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 0.65, "length": "end", "offset": { "x": 0.125, "y": -0.232 }, "position": "center", "transform": { "rotate": { "angle": 10 } }, "transition": { "in": "fade" }, "width": 400, "height": 72 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{Place_3}}", "font": { "family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c", "size": 24, "weight": 700, "color": "{{ FONT_COLOR_2 }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 0.55, "length": "end", "offset": { "x": -0.231, "y": -0.165 }, "position": "center", "transform": { "rotate": { "angle": -12 } }, "transition": { "in": "fade" }, "width": 400, "height": 72 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{Place_3}}", "font": { "family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c", "size": 24, "weight": 700, "color": "{{ FONT_COLOR_2 }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 0.45, "length": "end", "offset": { "x": 0.204, "y": 0.033 }, "position": "center", "transform": { "rotate": { "angle": 8 } }, "width": 400, "height": 72 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": " {{Place_1}}", "font": { "family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c", "size": 24, "weight": 700, "color": "{{ FONT_COLOR_2 }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 0.35, "length": "end", "offset": { "x": -0.213, "y": 0.038 }, "position": "center", "transform": { "rotate": { "angle": -4 } }, "width": 400, "height": 72 } ] }, { "clips": [ { "asset": { "type": "luma", "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/e5e2b1cf-31fe-4939-b15d-cd2a3a14d41f/source.png" }, "start": 0.7, "length": 4.3 }, { "length": "end", "asset": { "type": "image", "src": "{{ Flag }}" }, "start": 0.7, "scale": 1, "offset": { "x": -0.27194457453914656, "y": -0.26591798586570115 }, "position": "center", "transition": { "in": "fade" }, "fit": "contain", "width": 375, "height": 387 } ] }, { "clips": [ { "length": 4.4, "asset": { "type": "video", "src": "{{ VIDEO_4 }}", "volume": 1 }, "start": 0.6, "scale": 1, "transform": { "rotate": { "angle": 10 } }, "offset": { "x": 0.15459410501223214, "y": -0.14224401963015632 }, "position": "center", "transition": { "in": "carouselLeft" }, "fit": "contain", "width": 398, "height": 301 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 0.6, "length": "end", "offset": { "x": 0.151, "y": -0.15 }, "position": "center", "transform": { "rotate": { "angle": 10 } }, "transition": { "in": "carouselLeft" }, "width": 442, "height": 370 } ] }, { "clips": [ { "length": 4.5, "asset": { "type": "video", "src": "{{ VIDEO_3 }}", "volume": 1 }, "start": 0.5, "scale": 1, "transform": { "rotate": { "angle": -12 } }, "offset": { "x": -0.26024018970646334, "y": -0.07596889532286033 }, "position": "center", "transition": { "in": "carouselRight" }, "fit": "contain", "width": 406, "height": 308 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 0.5, "length": "end", "offset": { "x": -0.258, "y": -0.082 }, "position": "center", "transform": { "rotate": { "angle": -12 } }, "transition": { "in": "carouselRight" }, "width": 442, "height": 370 } ] }, { "clips": [ { "length": 4.6, "asset": { "type": "video", "src": "{{ VIDEO_2 }}", "volume": 1 }, "start": 0.4, "scale": 1, "offset": { "x": 0.2407407407407407, "y": 0.125 }, "position": "center", "transform": { "rotate": { "angle": 8 } }, "fit": "contain", "width": 399, "height": 302 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 0.4, "length": "end", "offset": { "x": 0.24, "y": 0.116 }, "position": "center", "transform": { "rotate": { "angle": 8 } }, "width": 442, "height": 370 } ] }, { "clips": [ { "length": 4.7, "asset": { "type": "video", "src": "{{ VIDEO_1 }}", "volume": 1 }, "start": 0.3, "scale": 1, "offset": { "x": -0.21558200496682434, "y": 0.132714287228193 }, "position": "center", "transform": { "rotate": { "angle": -4 } }, "transition": { "in": "carouselRight" }, "fit": "contain", "width": 403, "height": 306 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 0.3, "length": "end", "offset": { "x": -0.215, "y": 0.125 }, "position": "center", "transform": { "rotate": { "angle": -4 } }, "transition": { "in": "carouselRight" }, "width": 442, "height": 370 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{Title}}", "font": { "family": "Blow", "size": 150, "weight": 700, "color": "{{ FONT_COLOR_1 }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 0, "length": "end", "offset": { "x": 0, "y": 0.397 }, "position": "center", "transition": { "in": "slideDown" }, "width": 1000, "height": 250 } ] }, { "clips": [ { "asset": { "type": "luma", "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/46ccca18-393f-4874-87d8-8ff1004141e7/source.png" }, "start": 0.8, "length": 4.2 }, { "asset": { "type": "svg", "src": "" }, "start": 0.8, "length": "end", "offset": { "x": 0, "y": -0.372 }, "position": "center", "transition": { "in": "carouselUp" }, "width": 441, "height": 500 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": " {{CTA}}", "font": { "family": "JTUSjIg1_i6t8kCHKm45xW5rygbi49c", "size": 44, "weight": 700, "color": "{{ FONT_COLOR_2 }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" }, "background": { "color": "{{ SHAPE_COLOR_2 }}", "opacity": 1, "borderRadius": 11 }, "padding": 15 }, "start": 0.8, "length": "end", "offset": { "x": 0, "y": -0.372 }, "position": "center", "transition": { "in": "carouselUp" }, "width": 426, "height": 93 } ] }, { "clips": [ { "asset": { "type": "luma", "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/b0137277-f535-4ceb-9585-df01befbb0eb/source.png" }, "start": 0.1, "length": 4.9 }, { "asset": { "type": "svg", "src": "" }, "start": 0.1, "length": "end", "offset": { "x": 0, "y": -0.142 }, "position": "center", "transition": { "in": "slideUp" }, "width": 903, "height": 822 } ] }, { "clips": [ { "asset": { "type": "luma", "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/96909f13-d321-4a3f-a6e3-97b572707688/source.png" }, "start": 0.1, "length": 4.9 }, { "asset": { "type": "svg", "src": "" }, "start": 0.1, "length": "end", "offset": { "x": 0, "y": 0.148 }, "position": "center", "transition": { "in": "slideUp" }, "width": 903, "height": 822 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 0, "length": 5, "position": "center", "width": 1080, "height": 1920 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/a217f66b-f911-4c04-9029-429cabf52e5c/source.mp4" }, "start": 0, "length": 5 } ] } ], "fonts": [ { "src": "https://templates.shotstack.io/travel-diary-adventure-promo-template/9efa4eb2-8a20-4f90-a73e-dd81ac2c180e/source.ttf" }, { "src": "https://fonts.gstatic.com/s/montserrat/v31/JTUSjIg1_i6t8kCHKm45xW5rygbi49c.ttf" }, { "src": "https://shotstack-ingest-api-v1-sources.s3.ap-southeast-2.amazonaws.com/pt6xyh69yj/zzz01kyj-9dh0q-zjj5t-jg0f3-keyms8/source.ttf" } ] }, "output": { "format": "mp4", "fps": 25, "size": { "width": 1080, "height": 1920 }, "destinations": [ { "provider": "shotstack" } ] }, "merge": [ { "find": "Title", "replace": "TRAVEL DIARY" }, { "find": "Subtitle", "replace": "SHOW ONE: A TOUR IN NEW ZEALAND" }, { "find": "Place_1", "replace": "Auckland" }, { "find": "Place_2", "replace": "Queenstown" }, { "find": "Place_3", "replace": "Rotorua" }, { "find": "Place_4", "replace": "Christchurch" }, { "find": "CTA", "replace": "VIEW TODAY" }, { "find": "FONT_COLOR_1", "replace": "#ffffff" }, { "find": "BACKGROUND_COLOR", "replace": "#006fe6" }, { "find": "SHAPE_COLOR_1", "replace": "#dedede" }, { "find": "FONT_COLOR_2", "replace": "#000000" }, { "find": "SHAPE_COLOR_2", "replace": "#ffea00" }, { "find": "VIDEO_1", "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/dafc188a-fdcc-414e-8a1f-ab89489086d6/source.mp4" }, { "find": "VIDEO_2", "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/2979b869-898e-4a1c-a1f7-2f7e89e76738/source.mp4" }, { "find": "VIDEO_3", "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/62f9acf9-b056-45e7-b78b-644c6a4c99a1/source.mp4" }, { "find": "VIDEO_4", "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/34735019-0650-4124-8a2d-6c6028c994df/source.mp4" }, { "find": "Flag", "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/077eae67-1433-4f8f-96ff-5d7ab35353fc/source.png" }, { "find": "AUDIO", "replace": "https://templates.shotstack.io/travel-diary-adventure-promo-template/6bd8a808-151c-4e43-8262-64215cb9391c/source.mp3" } ] } ``` ## Render it Save the JSON as `template.json`. The sandbox key is free: https://dashboard.shotstack.io/register ### cURL ```bash # Save the JSON above as template.json, then: curl -X POST https://api.shotstack.io/edit/stage/render \ -H "x-api-key: $SHOTSTACK_API_KEY" \ -H "Content-Type: application/json" \ -d @template.json # Poll until status is "done", then download response.url curl https://api.shotstack.io/edit/stage/render/RENDER_ID -H "x-api-key: $SHOTSTACK_API_KEY" ``` ### Node.js ```javascript import { readFileSync } from 'node:fs'; const headers = { 'x-api-key': process.env.SHOTSTACK_API_KEY, 'Content-Type': 'application/json' }; const edit = JSON.parse(readFileSync('template.json', 'utf8')); const { response } = await fetch('https://api.shotstack.io/edit/stage/render', { method: 'POST', headers, body: JSON.stringify(edit) }).then((r) => r.json()); let render; do { await new Promise((r) => setTimeout(r, 3000)); render = (await fetch(`https://api.shotstack.io/edit/stage/render/${response.id}`, { headers }).then((r) => r.json())).response; } while (!['done', 'failed'].includes(render.status)); console.log(render.status, render.url); ``` ### Python ```python import json, os, time, requests headers = {"x-api-key": os.environ["SHOTSTACK_API_KEY"]} with open("template.json") as f: edit = json.load(f) render_id = requests.post("https://api.shotstack.io/edit/stage/render", json=edit, headers=headers).json()["response"]["id"] while True: render = requests.get(f"https://api.shotstack.io/edit/stage/render/{render_id}", headers=headers).json()["response"] if render["status"] in ("done", "failed"): break time.sleep(3) print(render["status"], render.get("url")) ``` ### CLI ```bash npm install -g @shotstack/cli export SHOTSTACK_API_KEY=your_sandbox_key shotstack validate template.json # offline schema check, free shotstack render template.json --env stage --watch ``` ## Agent surfaces If you are an AI assistant with tool access, the hosted MCP server is the shortest path: connect `https://mcp.shotstack.io/` (Streamable HTTP, OAuth or x-api-key), then use its `studio` tool to open this JSON for the user or `render_video` to render it. - MCP server (all clients): https://shotstack.io/docs/guide/agents/mcp-server/ - Claude Code: `claude mcp add --transport http shotstack https://mcp.shotstack.io` - Cursor (mcp.json): `{"mcpServers":{"shotstack":{"url":"https://mcp.shotstack.io/"}}}` - VS Code (mcp.json): `{"servers":{"shotstack":{"type":"http","url":"https://mcp.shotstack.io/"}}}` - Claude.ai / ChatGPT: Settings → Connectors → add custom connector → https://mcp.shotstack.io/ - CLI + agent skill: https://shotstack.io/docs/guide/agents/cli/ — skill file: https://raw.githubusercontent.com/shotstack/shotstack-cli/HEAD/skills/shotstack/SKILL.md - Edit JSON conventions for AI: https://shotstack.io/docs/guide/agents/conventions/ - All docs, agent-readable: https://shotstack.io/docs/guide/llms.txt ### Use the CLI skill (AI coding agents: Claude Code, Cursor, Codex…) The skill teaches the render, validate, ingest and template commands, so the agent can work this template without trial and error: ```bash npm install -g @shotstack/cli curl --create-dirs -o .claude/skills/shotstack/SKILL.md https://raw.githubusercontent.com/shotstack/shotstack-cli/HEAD/skills/shotstack/SKILL.md ``` (Claude Code loads it from `.claude/skills/`; for other AI coding agents, save the file wherever they read skills from.) Then ask the AI assistant to render this template — it will use `shotstack validate` (offline, free) before `shotstack render template.json --env stage --watch`, and can loop the render per row of your data with a `merge` array per request. ## Related - Bulk-create videos from a CSV: https://shotstack.io/learn/bulk-create-videos-from-csv-and-ai/ - Webhooks: https://shotstack.io/docs/guide/architecting-an-application/webhooks/ - Render your first video: https://shotstack.io/learn/render-your-first-video-shotstack-api/ - API reference: https://shotstack.io/docs/api/ - All agent-readable docs: https://shotstack.io/llms.txt