# Tropical Escape: Vacation & Travel Offer Template (video template) > Promote your exclusive travel deals with our stunning vacation offer template. Perfect for hotels, resorts, and travel agencies. ## Overview - **Page**: https://shotstack.io/studio/templates/vacation-getaway-travel-offer-template-v2/ - **Output**: MP4, 1080x1920 (9:16), 25 fps - **Length**: 20s - **Timeline**: 28 clips on 23 tracks; assets: audio, 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=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3ZhY2F0aW9uLWdldGF3YXktdHJhdmVsLW9mZmVyLXRlbXBsYXRlLzZiODc5ZDljLTU0MDgtNGE1Ni05MmMyLTVkNmExMGMyYjZkZi9zb3VyY2UudHRmIn0seyJzcmMiOiJodHRwczovL2ZvbnRzLmdzdGF0aWMuY29tL3MvZ3JlYXR2aWJlcy92MjEvUldtTW9LV1I5djRrc01mYVdkX0pOLVhDZzZVS0RYbHEudHRmIn1dLCJiYWNrZ3JvdW5kIjoiI0ZGRkZGRiIsInRyYWNrcyI6W3siY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJhdWRpbyIsInNyYyI6Int7IEFVRElPIH19Iiwidm9sdW1lIjoxfSwic3RhcnQiOjB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1M0X0JvZHl9fSIsImZvbnQiOnsiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjQ2LCJ3ZWlnaHQiOjYwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifSwiYW5pbWF0aW9uIjp7InByZXNldCI6ImZhZGVJbiIsInN0eWxlIjoid29yZCJ9fSwic3RhcnQiOjE1LjQsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLCJ5IjotMC4wNDZ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0In0sIndpZHRoIjo3MDAsImhlaWdodCI6NzJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1M0X1N1YnRpdGxlfX0iLCJmb250Ijp7ImZhbWlseSI6IkdyZWF0IFZpYmVzIiwic2l6ZSI6MTIwLCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifX0sInN0YXJ0IjoxNSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMDIxfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7Im91dCI6InNsaWRlTGVmdCJ9LCJ3aWR0aCI6NDAwLCJoZWlnaHQiOjIwMH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDIwMCAyMDBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCIyMDBcIiBoZWlnaHQ9XCIyMDBcIiBmaWxsPVwie3sgRk9OVF9DT0xPUiB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjE1LCJsZW5ndGgiOiJlbmQiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjoxODB9fSwib2Zmc2V0Ijp7InkiOi0wLjM1NSwieCI6MC4yNzh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0In0sIndpZHRoIjoyMDAsImhlaWdodCI6MjAwfSx7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3ZhY2F0aW9uLWdldGF3YXktdHJhdmVsLW9mZmVyLXRlbXBsYXRlLzVhYTU1ZmNjLTY1NDItNDA4YS1hYjgzLTVmYzVjNWJjNTYxYS9zb3VyY2UubXA0In0sInN0YXJ0IjoxNSwibGVuZ3RoIjo1fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6ImVuZCIsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFM0X1ZJREVPIH19In0sInN0YXJ0IjoxNC42LCJzY2FsZSI6MSwidHJhbnNpdGlvbiI6eyJvdXQiOiJzbGlkZUxlZnQifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjo4NDAsImhlaWdodCI6MTQ5MSwib2Zmc2V0Ijp7IngiOjAsInkiOjB9fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgOTAyIDE1NzZcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI5MDJcIiBoZWlnaHQ9XCIxNTc2XCIgZmlsbD1cInt7IEZPTlRfQ09MT1IgfX1cIiBmaWxsLW9wYWNpdHk9XCIwLjg3XCIvPjwvc3ZnPiJ9LCJzdGFydCI6MTQuNiwibGVuZ3RoIjoiZW5kIiwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0In0sIndpZHRoIjo5MDIsImhlaWdodCI6MTU3Nn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7UzNfQm9keX19IiwiZm9udCI6eyJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6NDYsIndlaWdodCI6NjAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJyaWdodCIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJmYWRlSW4iLCJzdHlsZSI6IndvcmQifX0sInN0YXJ0IjoxMC42LCJsZW5ndGgiOjQsIm9mZnNldCI6eyJ4IjowLjAzNCwieSI6LTAuMzQyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7Im91dCI6InNsaWRlTGVmdCIsImluIjoic2xpZGVMZWZ0In0sIndpZHRoIjo3MDAsImhlaWdodCI6NzJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1MzX1N1YnRpdGxlfX0iLCJmb250Ijp7ImZhbWlseSI6IkdyZWF0IFZpYmVzIiwic2l6ZSI6MTIwLCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifX0sInN0YXJ0IjoxMC4yLCJsZW5ndGgiOjQuNCwib2Zmc2V0Ijp7IngiOjAuMjA5LCJ5IjotMC4yNzF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQiLCJvdXQiOiJzbGlkZUxlZnQifSwid2lkdGgiOjQwMCwiaGVpZ2h0IjoyMDB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCAyMDAgMjAwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiMjAwXCIgaGVpZ2h0PVwiMjAwXCIgZmlsbD1cInt7IEZPTlRfQ09MT1IgfX1cIi8-PC9zdmc-In0sInN0YXJ0IjoxMC4yLCJsZW5ndGgiOjQuNCwib2Zmc2V0Ijp7IngiOi0wLjI5LCJ5IjotMC4yNzF9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0IiwiaW4iOiJzbGlkZUxlZnQifSwid2lkdGgiOjIwMCwiaGVpZ2h0IjoyMDB9LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvYmEzOGExMDAtNDYxNi00MjBjLTkxODAtODdiMzNkZWFmNjdjL3NvdXJjZS5tcDQifSwic3RhcnQiOjEwLjIsImxlbmd0aCI6NC40fV19LHsiY2xpcHMiOlt7Imxlbmd0aCI6NC44LCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBTM19WSURFTyB9fSIsInZvbHVtZSI6MH0sInN0YXJ0Ijo5LjgsInNjYWxlIjoxLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0Iiwib3V0Ijoic2xpZGVMZWZ0In0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6ODU4LCJoZWlnaHQiOjE1MzEsIm9mZnNldCI6eyJ4IjowLCJ5IjowfX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDkwMiAxNjgyXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiOTAyXCIgaGVpZ2h0PVwiMTY4MlwiIGZpbGw9XCJ7eyBGT05UX0NPTE9SIH19XCIgZmlsbC1vcGFjaXR5PVwiMC44N1wiLz48L3N2Zz4ifSwic3RhcnQiOjkuOCwibGVuZ3RoIjo0LjgsInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJvdXQiOiJzbGlkZUxlZnQiLCJpbiI6InNsaWRlTGVmdCJ9LCJ3aWR0aCI6OTAyLCJoZWlnaHQiOjE2ODJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1MyX0JvZHl9fSIsImZvbnQiOnsiZmFtaWx5IjoiTW9udHNlcnJhdCBTZW1pQm9sZCIsInNpemUiOjQ2LCJ3ZWlnaHQiOjYwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoibGVmdCIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJmYWRlSW4iLCJzdHlsZSI6IndvcmQifX0sInN0YXJ0Ijo1LjgsImxlbmd0aCI6NCwib2Zmc2V0Ijp7IngiOi0wLjAyMSwieSI6LTAuMzMyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0Iiwib3V0Ijoic2xpZGVMZWZ0In0sIndpZHRoIjo3MDAsImhlaWdodCI6NzJ9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InJpY2gtdGV4dCIsInRleHQiOiJ7e1MyX1N1YnRpdGxlfX0iLCJmb250Ijp7ImZhbWlseSI6IkdyZWF0IFZpYmVzIiwic2l6ZSI6MTIwLCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBGT05UX0NPTE9SIH19Iiwib3BhY2l0eSI6MX0sInN0eWxlIjp7ImxldHRlclNwYWNpbmciOjAsIndvcmRTcGFjaW5nIjowLCJsaW5lSGVpZ2h0IjoxLCJ0ZXh0VHJhbnNmb3JtIjoibm9uZSIsInRleHREZWNvcmF0aW9uIjoibm9uZSJ9LCJhbGlnbiI6eyJob3Jpem9udGFsIjoiY2VudGVyIiwidmVydGljYWwiOiJtaWRkbGUifX0sInN0YXJ0Ijo1LjQsImxlbmd0aCI6NC40LCJvZmZzZXQiOnsieCI6LTAuMjE1LCJ5IjotMC4yNTJ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsib3V0Ijoic2xpZGVMZWZ0IiwiaW4iOiJzbGlkZUxlZnQifSwid2lkdGgiOjQwMCwiaGVpZ2h0IjoyMDB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCAyMDAgMjAwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiMjAwXCIgaGVpZ2h0PVwiMjAwXCIgZmlsbD1cInt7IEZPTlRfQ09MT1IgfX1cIi8-PC9zdmc-In0sInN0YXJ0Ijo1LjQsImxlbmd0aCI6NC40LCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjoxODB9fSwib2Zmc2V0Ijp7IngiOjAuMjg4LCJ5IjotMC4yNTh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQiLCJvdXQiOiJzbGlkZUxlZnQifSwid2lkdGgiOjIwMCwiaGVpZ2h0IjoyMDB9LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvYmNkMGYwMTItZGZlYS00N2I1LTllMDYtNTBmNjkzNTJjNDgzL3NvdXJjZS5tcDQifSwic3RhcnQiOjUuNCwibGVuZ3RoIjo0LjR9XX0seyJjbGlwcyI6W3sibGVuZ3RoIjo0LjgsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMyX1ZJREVPIH19Iiwidm9sdW1lIjowfSwic3RhcnQiOjUsInNjYWxlIjoxLCJ0cmFuc2l0aW9uIjp7Im91dCI6InNsaWRlTGVmdCIsImluIjoic2xpZGVMZWZ0In0sImZpdCI6ImNvbnRhaW4iLCJ3aWR0aCI6ODYxLCJoZWlnaHQiOjE1MjksIm9mZnNldCI6eyJ4IjowLjAwMjA3MDYzMDA3OTczMTI2NywieSI6LTAuMDAwNTg4ODcxODk1NDIxMzQ2OH19XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCA5MDIgMTU3NlwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjkwMlwiIGhlaWdodD1cIjE1NzZcIiBmaWxsPVwie3sgRk9OVF9DT0xPUiB9fVwiIGZpbGwtb3BhY2l0eT1cIjAuODdcIi8-PC9zdmc-In0sInN0YXJ0Ijo1LCJsZW5ndGgiOjQuOCwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0Iiwib3V0Ijoic2xpZGVMZWZ0In0sIndpZHRoIjo5MDIsImhlaWdodCI6MTU3Nn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7UzFfVGl0bGV9fSIsImZvbnQiOnsiZmFtaWx5IjoiR3JlYXQgVmliZXMiLCJzaXplIjoxMjAsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IEZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9LCJiYWNrZ3JvdW5kIjp7Im9wYWNpdHkiOjAuMTIsImJvcmRlclJhZGl1cyI6MH0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJmYWRlSW4iLCJzdHlsZSI6IndvcmQifX0sInN0YXJ0IjoxLCJsZW5ndGgiOjQsInRyYW5zaXRpb24iOnsib3V0IjoiZmFkZSIsImluIjoiZmFkZSJ9LCJ3aWR0aCI6NjAwLCJoZWlnaHQiOjMwMH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDI1MCAyNTBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCIyNTBcIiBoZWlnaHQ9XCIyNTBcIiBmaWxsPVwie3sgRk9OVF9DT0xPUiB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjAuNywibGVuZ3RoIjo0LjMsIm9mZnNldCI6eyJ4IjotMC4zNDcsInkiOjAuNDM1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ3aWR0aCI6MjUwLCJoZWlnaHQiOjI1MH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby92YWNhdGlvbi1nZXRhd2F5LXRyYXZlbC1vZmZlci10ZW1wbGF0ZS9lY2Q3Y2Q5ZS1lYTczLTQyOTQtYjM0MC04YWMxODA2ZTc1Mjcvc291cmNlLm1wNCJ9LCJzdGFydCI6MC43LCJsZW5ndGgiOjQuM31dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjQuMzIsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMxX1ZJREVPXzEgfX0iLCJ2b2x1bWUiOjB9LCJzdGFydCI6MC43LCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAsInkiOi0wLjMyNX0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQiLCJvdXQiOiJzbGlkZUxlZnQifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxMDI4LCJoZWlnaHQiOjU4MX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjQuNiwiYXNzZXQiOnsidHlwZSI6InZpZGVvIiwic3JjIjoie3sgUzFfVklERU9fMiB9fSIsInZvbHVtZSI6MH0sInN0YXJ0IjowLjQsInNjYWxlIjoxLCJ0cmFuc2l0aW9uIjp7Im91dCI6InNsaWRlTGVmdCIsImluIjoic2xpZGVSaWdodCJ9LCJmaXQiOiJjb250YWluIiwid2lkdGgiOjEwMjgsImhlaWdodCI6NTgxfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgMjUwIDI1MFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjI1MFwiIGhlaWdodD1cIjI1MFwiIGZpbGw9XCJ7eyBGT05UX0NPTE9SIH19XCIvPjwvc3ZnPiJ9LCJzdGFydCI6MCwibGVuZ3RoIjo1LCJvZmZzZXQiOnsieCI6LTAuMzQ3LCJ5IjowLjQzNX0sInBvc2l0aW9uIjoiY2VudGVyIiwid2lkdGgiOjI1MCwiaGVpZ2h0IjoyNTB9LHsiYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvYTRhODcxZmYtMTc2My00NzFiLWFiNGEtNzVkZmU1NzAwMjY5L3NvdXJjZS5tcDQifSwic3RhcnQiOjAsImxlbmd0aCI6NX1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOjUsImFzc2V0Ijp7InR5cGUiOiJ2aWRlbyIsInNyYyI6Int7IFMxX1ZJREVPXzMgfX0iLCJ2b2x1bWUiOjB9LCJzdGFydCI6MCwic2NhbGUiOjEsIm9mZnNldCI6eyJ4IjowLjAwMDYyMDA0MTMzMzQxMjI4MzksInkiOjAuMzI2NTI0NDQ1NjY5NDA4N30sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQiLCJvdXQiOiJzbGlkZUxlZnQifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxMDI4LCJoZWlnaHQiOjU4MX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoic3ZnIiwic3JjIjoiPHN2ZyB2aWV3Qm94PVwiMCAwIDEwODAgMTkyMFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjEwODBcIiBoZWlnaHQ9XCIxOTIwXCIgZmlsbD1cInt7IEJBQ0tHUk9VTkRfQ09MT1IgfX1cIi8-PC9zdmc-In0sInN0YXJ0IjowLCJsZW5ndGgiOjIwLCJwb3NpdGlvbiI6ImNlbnRlciIsIndpZHRoIjoxMDgwLCJoZWlnaHQiOjE5MjB9XX1dfSwib3V0cHV0Ijp7ImZvcm1hdCI6Im1wNCIsImZwcyI6MjUsInNpemUiOnsid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMH0sImRlc3RpbmF0aW9ucyI6W3sicHJvdmlkZXIiOiJzaG90c3RhY2sifV19LCJtZXJnZSI6W3siZmluZCI6IlMxX1RpdGxlIiwicmVwbGFjZSI6Ik15IFZhY2F0aW9uIFBsYW4ifSx7ImZpbmQiOiJTMV9WSURFT18xIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby92YWNhdGlvbi1nZXRhd2F5LXRyYXZlbC1vZmZlci10ZW1wbGF0ZS8xNTgzNDdiYS0xMzc2LTQyNDgtODA5YS05ZDdiNGE4MTI3MDIvc291cmNlLm1wNCJ9LHsiZmluZCI6IlMxX1ZJREVPXzIiLCJyZXBsYWNlIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL3ZhY2F0aW9uLWdldGF3YXktdHJhdmVsLW9mZmVyLXRlbXBsYXRlLzY2ZWM1MWIyLTk5YjQtNDQxMy05YTc4LTc0NTE1NGY3MTA2YS9zb3VyY2UubXA0In0seyJmaW5kIjoiUzFfVklERU9fMyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvYTRlZTM3N2EtNjNlMC00YTYwLWFlYjAtZTk4Mzk3NzY5NWJiL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTMl9TdWJ0aXRsZSIsInJlcGxhY2UiOiJEYXkgMSJ9LHsiZmluZCI6IlMyX0JvZHkiLCJyZXBsYWNlIjoiZXhwbG9yaW5nIGFydCAmIGNhZsOpcyBpbiBQYXJpcyJ9LHsiZmluZCI6IlMyX1ZJREVPIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby92YWNhdGlvbi1nZXRhd2F5LXRyYXZlbC1vZmZlci10ZW1wbGF0ZS85Nzg4OGNlOC05MmM2LTQyYTctYTc3NS01NDQ5Nzg5OGU2YmEvc291cmNlLm1wNCJ9LHsiZmluZCI6IlMzX1N1YnRpdGxlIiwicmVwbGFjZSI6IkRheSAyIn0seyJmaW5kIjoiUzNfQm9keSIsInJlcGxhY2UiOiJDYW1waW5nIHVuZGVyIHRoZSBOb3J0aGVybiBMaWdodHMgaW4gRmlubGFuZCJ9LHsiZmluZCI6IlMzX1ZJREVPIiwicmVwbGFjZSI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby92YWNhdGlvbi1nZXRhd2F5LXRyYXZlbC1vZmZlci10ZW1wbGF0ZS9lZDcxNTBjNi0zZDc1LTQwZmEtYTA5Mi04YzU5ZjRlNTQzNDQvc291cmNlLm1wNCJ9LHsiZmluZCI6IlM0X1N1YnRpdGxlIiwicmVwbGFjZSI6IkRheSAzIn0seyJmaW5kIjoiUzRfQm9keSIsInJlcGxhY2UiOiJIaWtpbmcgaW4gdGhlIFN3aXNzIEFscHMifSx7ImZpbmQiOiJTNF9WSURFTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvZjU5NGM2NzMtMGY5Mi00YjJmLWI2ZjQtZmJmNDM1YzU5MTk3L3NvdXJjZS5tcDQifSx7ImZpbmQiOiJGT05UX0NPTE9SIiwicmVwbGFjZSI6IiNmZmZmZmYifSx7ImZpbmQiOiJCQUNLR1JPVU5EX0NPTE9SIiwicmVwbGFjZSI6IiMwMjUyNmMifSx7ImZpbmQiOiJBVURJTyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vdmFjYXRpb24tZ2V0YXdheS10cmF2ZWwtb2ZmZXItdGVtcGxhdGUvOTRiMjBlYWEtNmFkMC00N2E4LTljYmItMTU3Y2M1MDdiNTY0L3NvdXJjZS5tcDMifV19 - **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/vacation-getaway-travel-offer-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 | | --- | --- | | `{{ S1_Title }}` | My Vacation Plan | | `{{ S1_VIDEO_1 }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/158347ba-1376-4248-809a-9d7b4a812702/source.mp4 | | `{{ S1_VIDEO_2 }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/66ec51b2-99b4-4413-9a78-745154f7106a/source.mp4 | | `{{ S1_VIDEO_3 }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/a4ee377a-63e0-4a60-aeb0-e983977695bb/source.mp4 | | `{{ S2_Subtitle }}` | Day 1 | | `{{ S2_Body }}` | exploring art & cafés in Paris | | `{{ S2_VIDEO }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/97888ce8-92c6-42a7-a775-54497898e6ba/source.mp4 | | `{{ S3_Subtitle }}` | Day 2 | | `{{ S3_Body }}` | Camping under the Northern Lights in Finland | | `{{ S3_VIDEO }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/ed7150c6-3d75-40fa-a092-8c59f4e54344/source.mp4 | | `{{ S4_Subtitle }}` | Day 3 | | `{{ S4_Body }}` | Hiking in the Swiss Alps | | `{{ S4_VIDEO }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/f594c673-0f92-4b2f-b6f4-fbf435c59197/source.mp4 | | `{{ FONT_COLOR }}` | #ffffff | | `{{ BACKGROUND_COLOR }}` | #02526c | | `{{ AUDIO }}` | https://templates.shotstack.io/vacation-getaway-travel-offer-template/94b20eaa-6ad0-47a8-9cbb-157cc507b564/source.mp3 | ## Template JSON ```json { "timeline": { "fonts": [ { "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/6b879d9c-5408-4a56-92c2-5d6a10c2b6df/source.ttf" }, { "src": "https://fonts.gstatic.com/s/greatvibes/v21/RWmMoKWR9v4ksMfaWd_JN-XCg6UKDXlq.ttf" } ], "background": "#FFFFFF", "tracks": [ { "clips": [ { "length": "end", "asset": { "type": "audio", "src": "{{ AUDIO }}", "volume": 1 }, "start": 0 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S4_Body}}", "font": { "family": "Montserrat SemiBold", "size": 46, "weight": 600, "color": "{{ FONT_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": 15.4, "length": "end", "offset": { "x": 0, "y": -0.046 }, "position": "center", "transition": { "out": "slideLeft" }, "width": 700, "height": 72 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S4_Subtitle}}", "font": { "family": "Great Vibes", "size": 120, "weight": 400, "color": "{{ FONT_COLOR }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 15, "length": "end", "offset": { "x": 0, "y": 0.021 }, "position": "center", "transition": { "out": "slideLeft" }, "width": 400, "height": 200 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 15, "length": "end", "transform": { "rotate": { "angle": 180 } }, "offset": { "y": -0.355, "x": 0.278 }, "position": "center", "transition": { "out": "slideLeft" }, "width": 200, "height": 200 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/5aa55fcc-6542-408a-ab83-5fc5c5bc561a/source.mp4" }, "start": 15, "length": 5 } ] }, { "clips": [ { "length": "end", "asset": { "type": "video", "src": "{{ S4_VIDEO }}" }, "start": 14.6, "scale": 1, "transition": { "out": "slideLeft" }, "fit": "contain", "width": 840, "height": 1491, "offset": { "x": 0, "y": 0 } } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 14.6, "length": "end", "position": "center", "transition": { "in": "slideLeft" }, "width": 902, "height": 1576 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S3_Body}}", "font": { "family": "Montserrat SemiBold", "size": 46, "weight": 600, "color": "{{ FONT_COLOR }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "right", "vertical": "middle" }, "animation": { "preset": "fadeIn", "style": "word" } }, "start": 10.6, "length": 4, "offset": { "x": 0.034, "y": -0.342 }, "position": "center", "transition": { "out": "slideLeft", "in": "slideLeft" }, "width": 700, "height": 72 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S3_Subtitle}}", "font": { "family": "Great Vibes", "size": 120, "weight": 400, "color": "{{ FONT_COLOR }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 10.2, "length": 4.4, "offset": { "x": 0.209, "y": -0.271 }, "position": "center", "transition": { "in": "slideLeft", "out": "slideLeft" }, "width": 400, "height": 200 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 10.2, "length": 4.4, "offset": { "x": -0.29, "y": -0.271 }, "position": "center", "transition": { "out": "slideLeft", "in": "slideLeft" }, "width": 200, "height": 200 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/ba38a100-4616-420c-9180-87b33deaf67c/source.mp4" }, "start": 10.2, "length": 4.4 } ] }, { "clips": [ { "length": 4.8, "asset": { "type": "video", "src": "{{ S3_VIDEO }}", "volume": 0 }, "start": 9.8, "scale": 1, "transition": { "in": "slideLeft", "out": "slideLeft" }, "fit": "contain", "width": 858, "height": 1531, "offset": { "x": 0, "y": 0 } } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 9.8, "length": 4.8, "position": "center", "transition": { "out": "slideLeft", "in": "slideLeft" }, "width": 902, "height": 1682 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S2_Body}}", "font": { "family": "Montserrat SemiBold", "size": 46, "weight": 600, "color": "{{ FONT_COLOR }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "left", "vertical": "middle" }, "animation": { "preset": "fadeIn", "style": "word" } }, "start": 5.8, "length": 4, "offset": { "x": -0.021, "y": -0.332 }, "position": "center", "transition": { "in": "slideLeft", "out": "slideLeft" }, "width": 700, "height": 72 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S2_Subtitle}}", "font": { "family": "Great Vibes", "size": 120, "weight": 400, "color": "{{ FONT_COLOR }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" } }, "start": 5.4, "length": 4.4, "offset": { "x": -0.215, "y": -0.252 }, "position": "center", "transition": { "out": "slideLeft", "in": "slideLeft" }, "width": 400, "height": 200 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 5.4, "length": 4.4, "transform": { "rotate": { "angle": 180 } }, "offset": { "x": 0.288, "y": -0.258 }, "position": "center", "transition": { "in": "slideLeft", "out": "slideLeft" }, "width": 200, "height": 200 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/bcd0f012-dfea-47b5-9e06-50f69352c483/source.mp4" }, "start": 5.4, "length": 4.4 } ] }, { "clips": [ { "length": 4.8, "asset": { "type": "video", "src": "{{ S2_VIDEO }}", "volume": 0 }, "start": 5, "scale": 1, "transition": { "out": "slideLeft", "in": "slideLeft" }, "fit": "contain", "width": 861, "height": 1529, "offset": { "x": 0.002070630079731267, "y": -0.0005888718954213468 } } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 5, "length": 4.8, "position": "center", "transition": { "in": "slideLeft", "out": "slideLeft" }, "width": 902, "height": 1576 } ] }, { "clips": [ { "asset": { "type": "rich-text", "text": "{{S1_Title}}", "font": { "family": "Great Vibes", "size": 120, "weight": 400, "color": "{{ FONT_COLOR }}", "opacity": 1 }, "style": { "letterSpacing": 0, "wordSpacing": 0, "lineHeight": 1, "textTransform": "none", "textDecoration": "none" }, "align": { "horizontal": "center", "vertical": "middle" }, "background": { "opacity": 0.12, "borderRadius": 0 }, "animation": { "preset": "fadeIn", "style": "word" } }, "start": 1, "length": 4, "transition": { "out": "fade", "in": "fade" }, "width": 600, "height": 300 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 0.7, "length": 4.3, "offset": { "x": -0.347, "y": 0.435 }, "position": "center", "width": 250, "height": 250 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/ecd7cd9e-ea73-4294-b340-8ac1806e7527/source.mp4" }, "start": 0.7, "length": 4.3 } ] }, { "clips": [ { "length": 4.32, "asset": { "type": "video", "src": "{{ S1_VIDEO_1 }}", "volume": 0 }, "start": 0.7, "scale": 1, "offset": { "x": 0, "y": -0.325 }, "position": "center", "transition": { "in": "slideRight", "out": "slideLeft" }, "fit": "contain", "width": 1028, "height": 581 } ] }, { "clips": [ { "length": 4.6, "asset": { "type": "video", "src": "{{ S1_VIDEO_2 }}", "volume": 0 }, "start": 0.4, "scale": 1, "transition": { "out": "slideLeft", "in": "slideRight" }, "fit": "contain", "width": 1028, "height": 581 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 0, "length": 5, "offset": { "x": -0.347, "y": 0.435 }, "position": "center", "width": 250, "height": 250 }, { "asset": { "type": "luma", "src": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/a4a871ff-1763-471b-ab4a-75dfe5700269/source.mp4" }, "start": 0, "length": 5 } ] }, { "clips": [ { "length": 5, "asset": { "type": "video", "src": "{{ S1_VIDEO_3 }}", "volume": 0 }, "start": 0, "scale": 1, "offset": { "x": 0.0006200413334122839, "y": 0.3265244456694087 }, "position": "center", "transition": { "in": "slideRight", "out": "slideLeft" }, "fit": "contain", "width": 1028, "height": 581 } ] }, { "clips": [ { "asset": { "type": "svg", "src": "" }, "start": 0, "length": 20, "position": "center", "width": 1080, "height": 1920 } ] } ] }, "output": { "format": "mp4", "fps": 25, "size": { "width": 1080, "height": 1920 }, "destinations": [ { "provider": "shotstack" } ] }, "merge": [ { "find": "S1_Title", "replace": "My Vacation Plan" }, { "find": "S1_VIDEO_1", "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/158347ba-1376-4248-809a-9d7b4a812702/source.mp4" }, { "find": "S1_VIDEO_2", "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/66ec51b2-99b4-4413-9a78-745154f7106a/source.mp4" }, { "find": "S1_VIDEO_3", "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/a4ee377a-63e0-4a60-aeb0-e983977695bb/source.mp4" }, { "find": "S2_Subtitle", "replace": "Day 1" }, { "find": "S2_Body", "replace": "exploring art & cafés in Paris" }, { "find": "S2_VIDEO", "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/97888ce8-92c6-42a7-a775-54497898e6ba/source.mp4" }, { "find": "S3_Subtitle", "replace": "Day 2" }, { "find": "S3_Body", "replace": "Camping under the Northern Lights in Finland" }, { "find": "S3_VIDEO", "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/ed7150c6-3d75-40fa-a092-8c59f4e54344/source.mp4" }, { "find": "S4_Subtitle", "replace": "Day 3" }, { "find": "S4_Body", "replace": "Hiking in the Swiss Alps" }, { "find": "S4_VIDEO", "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/f594c673-0f92-4b2f-b6f4-fbf435c59197/source.mp4" }, { "find": "FONT_COLOR", "replace": "#ffffff" }, { "find": "BACKGROUND_COLOR", "replace": "#02526c" }, { "find": "AUDIO", "replace": "https://templates.shotstack.io/vacation-getaway-travel-offer-template/94b20eaa-6ad0-47a8-9cbb-157cc507b564/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