# Live Smart in a Beautiful Modern Home (video template)
> Showcase bright, stylish interiors with pricing, key features, and contact details. Great for real estate marketing and listings.
## Overview
- **Page**: https://shotstack.io/studio/templates/live-smart-beautiful-modern-home-v2/
- **Output**: MP4, 1080x1920 (9:16), 25 fps
- **Length**: 10s
- **Timeline**: 23 clips on 17 tracks; assets: 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=eyJ0aW1lbGluZSI6eyJmb250cyI6W3sic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtc21hcnQtYmVhdXRpZnVsLW1vZGVybi1ob21lLzVlZjM0MDFjLThhNTUtNGI0NS1iMDBhLTQxMmZmYzExYjNmOS9fTE9JbXpESzdlclJqaHVuSXNwYU1neGc3b0UudHRmIn0seyJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbGl2ZS1zbWFydC1iZWF1dGlmdWwtbW9kZXJuLWhvbWUvOGMyNGMyYWEtYzU2OS00ODc0LThmNmYtY2ZhZDIzYTk0ZjRmL0I1MFRGNnhRcjJUWEpCbkdPRk1FNnU1T1I4M29SUDVxa0g3Z093LnR0ZiJ9LHsic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtc21hcnQtYmVhdXRpZnVsLW1vZGVybi1ob21lLzNjOGNiOTUzLWU2NGQtNDQ1OC05ZTcyLWJjNGRkNzlkM2E3NC9qaXp6UkZWS3NtNEJ0OVByYlN6QzRLTGxRVUY1bFJKZzVqLWw1UHZ5aGZUZGQ0VGNZTU5mLnR0ZiJ9LHsic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtc21hcnQtYmVhdXRpZnVsLW1vZGVybi1ob21lLzZjMWY4MmNlLTgwYzYtNDUxZS1hMWY4LWViNmQ1ZGY3YTk2MC9tdEdoNC1SR0pxZk12dDdQOEZVcjBRMWotSGYxQmtsbDhnLnR0ZiJ9LHsic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtc21hcnQtYmVhdXRpZnVsLW1vZGVybi1ob21lLzc3NWU1ZjI1LWUxNzQtNDYyNC1iZjBiLTVjNGU1YzMzNWVmMC9aZ05Oak9GRlBxX0FVSkQxdW15UzMwVy1YdWI4ekQxT2JoZURaYjlNLnR0ZiJ9LHsic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtc21hcnQtYmVhdXRpZnVsLW1vZGVybi1ob21lLzQwYzQzNTY0LTBlMjktNDE0MS1hYzlmLTk1OWQ2MDgzNzA5Yy9nYTZYYXhaR19HNU92Q2ZfcnQ3RkgzQjZCSExNRWRWT0VvYy50dGYifSx7InNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9saXZlLXNtYXJ0LWJlYXV0aWZ1bC1tb2Rlcm4taG9tZS9mOWEyYTgzMi00MmU1LTQ0NzYtOGE4NC1iNTllYmJmZmRkZjUvZ2E2WGF4WkdfRzVPdkNmX3J0N0ZIM0I2QkhMTUVkVk9Fb2MudHRmIn0seyJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbGl2ZS1zbWFydC1iZWF1dGlmdWwtbW9kZXJuLWhvbWUvNGEwMjViMWItNGY5Ni00OWUzLTk0M2YtMmEwODcxZTg5NzUwL0NIeV9WX1BmR1Zqb2JTQmtpaEhXRFQ5OFJWcDM3dzhqY0pwSDJRLnR0ZiJ9LHsic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtc21hcnQtYmVhdXRpZnVsLW1vZGVybi1ob21lLzZmNTEyNmQ0LTNjOWEtNGZhOS05YmM3LWE3M2Q3Mjg1MTA5NC9tdEdoNC1SR0pxZk12dDdQOEZVcjBRMWotSGYxQmtsbDhnLnR0ZiJ9LHsic3JjIjoiaHR0cHM6Ly9mb250cy5nc3RhdGljLmNvbS9zL2RpZGFjdGdvdGhpYy92MjEvYWhjZnY4cXoxenQ2aENDNUc0Rl9QNEFTcFV5U3AwTGxjeVEudHRmIn0seyJzcmMiOiJodHRwczovL2ZvbnRzLmdzdGF0aWMuY29tL3MvYWxlZ3JleWFzYW5zc2MvdjI0L210R2g0LVJHSnFmTXZ0N1A4RlVyMFExai1IZjFOazV2OWl4QUxZcy50dGYifV0sImJhY2tncm91bmQiOiIjRkZGRkZGIiwidHJhY2tzIjpbeyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbGl2ZS1zbWFydC1iZWF1dGlmdWwtbW9kZXJuLWhvbWUvNTRjODFmYjEtNDk1MS00M2MyLTg0ODktNGEyNjAwZWUxYjllL3NvdXJjZS5wbmcifSwic3RhcnQiOjAuMiwibGVuZ3RoIjo5Ljh9LHsiYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCA4MDAgNDAwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiODAwXCIgaGVpZ2h0PVwiNDAwXCIgZmlsbD1cInt7IFMxX0ZPTlRfQ09MT1IgfX1cIi8-PC9zdmc-In0sInN0YXJ0IjowLjIsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjotMC41NjUsInkiOjAuNDE3fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2Zvcm0iOnsicm90YXRlIjp7ImFuZ2xlIjo5MH19LCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6ODAwLCJoZWlnaHQiOjQwMH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7QkFUSFJPT01TfX0iLCJmb250Ijp7ImZhbWlseSI6Ik1vbnRzZXJyYXQgU2VtaUJvbGQiLCJzaXplIjo3Miwid2VpZ2h0Ijo2MDAsImNvbG9yIjoie3sgUzFfRk9OVF9DT0xPUiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImNlbnRlciIsInZlcnRpY2FsIjoibWlkZGxlIn19LCJzdGFydCI6MC41LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MC4yNDUsInkiOi0wLjMyfSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0In0sIndpZHRoIjoxMDAsImhlaWdodCI6MTAwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJyaWNoLXRleHQiLCJ0ZXh0Ijoie3tCRURST09NU319IiwiZm9udCI6eyJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6NzIsIndlaWdodCI6NjAwLCJjb2xvciI6Int7IFMxX0ZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJjZW50ZXIiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9fSwic3RhcnQiOjAuNCwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAuMjQ1LCJ5IjotMC4yNjh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQifSwid2lkdGgiOjEwMCwiaGVpZ2h0IjoxMDB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbGl2ZS1zbWFydC1iZWF1dGlmdWwtbW9kZXJuLWhvbWUvY2RlOGVkZDAtNmFkMi00NGIxLTg0NDYtMjU0ZDI1YmIxZWQ1L3NvdXJjZS5wbmcifSwic3RhcnQiOjAuNCwibGVuZ3RoIjo5LjZ9LHsiYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCA5MCA5MFwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjkwXCIgaGVpZ2h0PVwiOTBcIiBmaWxsPVwie3sgUzFfRk9OVF9DT0xPUiB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjAuNCwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAuMzQ5LCJ5IjotMC4yNjh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQifSwid2lkdGgiOjkwLCJoZWlnaHQiOjkwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtc21hcnQtYmVhdXRpZnVsLW1vZGVybi1ob21lLzljMzMwZmJkLWNiZDAtNDA5Yi1iNzEwLTMzOTk5Mzk4N2U1My9zb3VyY2UucG5nIn0sInN0YXJ0IjowLjUsImxlbmd0aCI6OS41fSx7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgODAgODBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCI4MFwiIGhlaWdodD1cIjgwXCIgZmlsbD1cInt7IFMxX0ZPTlRfQ09MT1IgfX1cIi8-PC9zdmc-In0sInN0YXJ0IjowLjUsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjM0OSwieSI6LTAuMzI1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0In0sIndpZHRoIjo4MCwiaGVpZ2h0Ijo4MH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7QUREUkVTU319IiwiZm9udCI6eyJmYW1pbHkiOiJEaWRhY3QgR290aGljIiwic2l6ZSI6NzIsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IFMxX0ZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJsZWZ0IiwidmVydGljYWwiOiJtaWRkbGUifSwiYW5pbWF0aW9uIjp7InByZXNldCI6InR5cGV3cml0ZXIiLCJzdHlsZSI6IndvcmQiLCJkaXJlY3Rpb24iOiJyaWdodCJ9fSwic3RhcnQiOjAuNiwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjE4NSwieSI6LTAuMzE1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6NTAwLCJoZWlnaHQiOjI2MX1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7U0laRX19IiwiZm9udCI6eyJmYW1pbHkiOiJEaWRhY3QgR290aGljIiwic2l6ZSI6NzIsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IFMxX0ZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJyaWdodCIsInZlcnRpY2FsIjoibWlkZGxlIn19LCJzdGFydCI6MC4zLCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MC4yNTUsInkiOi0wLjE5Nn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlTGVmdCJ9LCJ3aWR0aCI6NDAwLCJoZWlnaHQiOjIwMH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7QU1PVU5UfX0iLCJmb250Ijp7ImZhbWlseSI6IkRpZGFjdCBHb3RoaWMiLCJzaXplIjoxMTMsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IFMyX0ZPTlRfQ09MT1JfMiB9fSIsIm9wYWNpdHkiOjF9LCJzdHlsZSI6eyJsZXR0ZXJTcGFjaW5nIjowLCJ3b3JkU3BhY2luZyI6MCwibGluZUhlaWdodCI6MSwidGV4dFRyYW5zZm9ybSI6Im5vbmUiLCJ0ZXh0RGVjb3JhdGlvbiI6Im5vbmUifSwiYWxpZ24iOnsiaG9yaXpvbnRhbCI6ImxlZnQiLCJ2ZXJ0aWNhbCI6Im1pZGRsZSJ9fSwic3RhcnQiOjAuNSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjI0NSwieSI6LTAuMjA5fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6NDAwLCJoZWlnaHQiOjEzNn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7UzFfVElUTEV9fSIsImZvbnQiOnsiZmFtaWx5IjoiRGlkYWN0IEdvdGhpYyIsInNpemUiOjQ0LCJ3ZWlnaHQiOjQwMCwiY29sb3IiOiJ7eyBTMl9GT05UX0NPTE9SXzIgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJsZWZ0IiwidmVydGljYWwiOiJtaWRkbGUifX0sInN0YXJ0IjowLjQsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjotMC4yODQsInkiOi0wLjE2NH0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQifSwid2lkdGgiOjMwMCwiaGVpZ2h0Ijo2MH1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6Int7QlJBTkRfTkFNRX19IiwiZm9udCI6eyJmYW1pbHkiOiJNb250c2VycmF0IFNlbWlCb2xkIiwic2l6ZSI6NTQsIndlaWdodCI6NjAwLCJjb2xvciI6Int7IFMxX0ZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJyaWdodCIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJzbGlkZUluIiwiZGlyZWN0aW9uIjoibGVmdCIsInN0eWxlIjoid29yZCJ9fSwic3RhcnQiOjAsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjowLjEzOSwieSI6MC4zODZ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQifSwid2lkdGgiOjY1MCwiaGVpZ2h0IjoxMzV9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCAzMDAgMzAwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiMzAwXCIgaGVpZ2h0PVwiMzAwXCIgZmlsbD1cInt7IEVMRU1FTlRfQ09MT1JfMyB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjAsImxlbmd0aCI6ImVuZCIsIm9mZnNldCI6eyJ4IjotMC4zMzQsInkiOjAuNTM1fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVSaWdodCJ9LCJ3aWR0aCI6MzAwLCJoZWlnaHQiOjMwMH0seyJhc3NldCI6eyJ0eXBlIjoibHVtYSIsInNyYyI6Imh0dHBzOi8vdGVtcGxhdGVzLnNob3RzdGFjay5pby9saXZlLXNtYXJ0LWJlYXV0aWZ1bC1tb2Rlcm4taG9tZS84MTM4NmIzMS02MjJiLTQyZTYtOGQ1Yy05MWVhN2U5MDZjYWEvc291cmNlLnBuZyJ9LCJzdGFydCI6MCwibGVuZ3RoIjoxMH1dfSx7ImNsaXBzIjpbeyJsZW5ndGgiOiJlbmQiLCJhc3NldCI6eyJ0eXBlIjoidmlkZW8iLCJzcmMiOiJ7eyBWSURFT19TUkMgfX0iLCJ2b2x1bWUiOjB9LCJzdGFydCI6MC4yLCJzY2FsZSI6MSwib2Zmc2V0Ijp7IngiOjAuMTY2NTg2NjM3MTkwMDA0NzcsInkiOjAuMDc4NTk5MDgwNDAzNjQ1ODh9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQifSwiZml0IjoiY29udGFpbiIsIndpZHRoIjoxMTY1LCJoZWlnaHQiOjY2Mn1dfSx7ImNsaXBzIjpbeyJhc3NldCI6eyJ0eXBlIjoicmljaC10ZXh0IiwidGV4dCI6IiB7e1RJVExFfX0iLCJmb250Ijp7ImZhbWlseSI6IkFsZWdyZXlhIFNhbnMgU0MiLCJzaXplIjoxMjEsIndlaWdodCI6NDAwLCJjb2xvciI6Int7IFMxX0ZPTlRfQ09MT1IgfX0iLCJvcGFjaXR5IjoxfSwic3R5bGUiOnsibGV0dGVyU3BhY2luZyI6MCwid29yZFNwYWNpbmciOjAsImxpbmVIZWlnaHQiOjEsInRleHRUcmFuc2Zvcm0iOiJub25lIiwidGV4dERlY29yYXRpb24iOiJub25lIn0sImFsaWduIjp7Imhvcml6b250YWwiOiJyaWdodCIsInZlcnRpY2FsIjoibWlkZGxlIn0sImFuaW1hdGlvbiI6eyJwcmVzZXQiOiJzbGlkZUluIiwic3R5bGUiOiJ3b3JkIiwiZGlyZWN0aW9uIjoibGVmdCJ9fSwic3RhcnQiOjAuMSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOjAsInkiOjAuMzI2fSwicG9zaXRpb24iOiJjZW50ZXIiLCJ0cmFuc2l0aW9uIjp7ImluIjoic2xpZGVMZWZ0In0sIndpZHRoIjo5NTAsImhlaWdodCI6MTUwfV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgNjAwIDE3NVwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjYwMFwiIGhlaWdodD1cIjE3NVwiIGZpbGw9XCJ7eyBTMV9GT05UX0NPTE9SIH19XCIvPjwvc3ZnPiJ9LCJzdGFydCI6MC4zLCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6LTAuMjMxLCJ5IjotMC4xOTZ9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZVJpZ2h0In0sIndpZHRoIjo2MDAsImhlaWdodCI6MTc1fV19LHsiY2xpcHMiOlt7ImFzc2V0Ijp7InR5cGUiOiJsdW1hIiwic3JjIjoiaHR0cHM6Ly90ZW1wbGF0ZXMuc2hvdHN0YWNrLmlvL2xpdmUtc21hcnQtYmVhdXRpZnVsLW1vZGVybi1ob21lL2M1MWI5YmQzLTJmNGQtNDA2YS1hNmU4LTNmMjZlZGZkY2RkYi9zb3VyY2UucG5nIn0sInN0YXJ0IjowLjYsImxlbmd0aCI6OS40fSx7ImFzc2V0Ijp7InR5cGUiOiJzdmciLCJzcmMiOiI8c3ZnIHZpZXdCb3g9XCIwIDAgOTIyIDUzNVwiIHhtbG5zPVwiaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmdcIj48cmVjdCB3aWR0aD1cIjkyMlwiIGhlaWdodD1cIjUzNVwiIGZpbGw9XCJ7eyBTMV9GT05UX0NPTE9SIH19XCIvPjwvc3ZnPiJ9LCJzdGFydCI6MC42LCJsZW5ndGgiOiJlbmQiLCJvZmZzZXQiOnsieCI6MC4yMjIsInkiOi0wLjV9LCJwb3NpdGlvbiI6ImNlbnRlciIsInRyYW5zaXRpb24iOnsiaW4iOiJzbGlkZUxlZnQifSwid2lkdGgiOjkyMiwiaGVpZ2h0Ijo1MzV9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6Imx1bWEiLCJzcmMiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbGl2ZS1zbWFydC1iZWF1dGlmdWwtbW9kZXJuLWhvbWUvMTE0YWU1M2YtYzRmMy00NTQ3LTgzMmEtNzEyNTIyOTNjM2E0L3NvdXJjZS5wbmcifSwic3RhcnQiOjAuMSwibGVuZ3RoIjo5Ljl9LHsiYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCAzMDAgMzAwXCIgeG1sbnM9XCJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2Z1wiPjxyZWN0IHdpZHRoPVwiMzAwXCIgaGVpZ2h0PVwiMzAwXCIgZmlsbD1cInt7IEVMRU1FTlRfQ09MT1JfMiB9fVwiLz48L3N2Zz4ifSwic3RhcnQiOjAuMSwibGVuZ3RoIjoiZW5kIiwib2Zmc2V0Ijp7IngiOi0wLjMyNCwieSI6MC4zNn0sInBvc2l0aW9uIjoiY2VudGVyIiwidHJhbnNpdGlvbiI6eyJpbiI6InNsaWRlUmlnaHQifSwid2lkdGgiOjMwMCwiaGVpZ2h0IjozMDB9XX0seyJjbGlwcyI6W3siYXNzZXQiOnsidHlwZSI6InN2ZyIsInNyYyI6Ijxzdmcgdmlld0JveD1cIjAgMCAxMDgwIDE5MjBcIiB4bWxucz1cImh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnXCI-PHJlY3Qgd2lkdGg9XCIxMDgwXCIgaGVpZ2h0PVwiMTkyMFwiIGZpbGw9XCJ7eyBCQUNLR1JPVU5EX0NPTE9SIH19XCIvPjwvc3ZnPiJ9LCJzdGFydCI6MCwibGVuZ3RoIjoxMCwid2lkdGgiOjEwODAsImhlaWdodCI6MTkyMH1dfV19LCJvdXRwdXQiOnsiZm9ybWF0IjoibXA0IiwiZnBzIjoyNSwic2l6ZSI6eyJ3aWR0aCI6MTA4MCwiaGVpZ2h0IjoxOTIwfSwiZGVzdGluYXRpb25zIjpbeyJwcm92aWRlciI6InNob3RzdGFjayJ9XX0sIm1lcmdlIjpbeyJmaW5kIjoiQlJBTkRfTkFNRSIsInJlcGxhY2UiOiJOZXd5b3JrIFJlYWwgRXN0YXRlIn0seyJmaW5kIjoiVElUTEUiLCJyZXBsYWNlIjoiSG91c2UgZm9yIFNhbGUifSx7ImZpbmQiOiJTMV9USVRMRSIsInJlcGxhY2UiOiJTdGFydCBmcm9tIn0seyJmaW5kIjoiQU1PVU5UIiwicmVwbGFjZSI6IiQxNSwwMDAifSx7ImZpbmQiOiJBRERSRVNTIiwicmVwbGFjZSI6IjEyMyBBbnl3aGVyZSBTVC4sIEFueSBDaXR5LCBTVCAxMjM0NSJ9LHsiZmluZCI6IlNJWkUiLCJyZXBsYWNlIjoiMiw1MDAgU3FmdCJ9LHsiZmluZCI6IkJFRFJPT01TIiwicmVwbGFjZSI6IjMifSx7ImZpbmQiOiJCQVRIUk9PTVMiLCJyZXBsYWNlIjoiMiJ9LHsiZmluZCI6IlZJREVPX1NSQyIsInJlcGxhY2UiOiJodHRwczovL3RlbXBsYXRlcy5zaG90c3RhY2suaW8vbGl2ZS1zbWFydC1iZWF1dGlmdWwtbW9kZXJuLWhvbWUvNDIxNTlhNDktNzBkNC00ZjhhLWFjYmUtOWY0OWQ1NDdhYjJkL3NvdXJjZS5tcDQifSx7ImZpbmQiOiJTMV9GT05UX0NPTE9SIiwicmVwbGFjZSI6IiMxMjRiNWUifSx7ImZpbmQiOiJTMl9GT05UX0NPTE9SXzIiLCJyZXBsYWNlIjoiI2ZmZmZmZiJ9LHsiZmluZCI6IkJBQ0tHUk9VTkRfQ09MT1IiLCJyZXBsYWNlIjoiI2U1ZmZmZCJ9LHsiZmluZCI6IkVMRU1FTlRfQ09MT1JfMiIsInJlcGxhY2UiOiIjNGM4MDlhIn0seyJmaW5kIjoiRUxFTUVOVF9DT0xPUl8zIiwicmVwbGFjZSI6IiNjN2U4ZjAifV19
- **Edit and save to an account**: https://dashboard.shotstack.io/studio/editor/live-smart-beautiful-modern-home-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 |
| --- | --- |
| `{{ BRAND_NAME }}` | Newyork Real Estate |
| `{{ TITLE }}` | House for Sale |
| `{{ S1_TITLE }}` | Start from |
| `{{ AMOUNT }}` | $15,000 |
| `{{ ADDRESS }}` | 123 Anywhere ST., Any City, ST 12345 |
| `{{ SIZE }}` | 2,500 Sqft |
| `{{ BEDROOMS }}` | 3 |
| `{{ BATHROOMS }}` | 2 |
| `{{ VIDEO_SRC }}` | https://templates.shotstack.io/live-smart-beautiful-modern-home/42159a49-70d4-4f8a-acbe-9f49d547ab2d/source.mp4 |
| `{{ S1_FONT_COLOR }}` | #124b5e |
| `{{ S2_FONT_COLOR_2 }}` | #ffffff |
| `{{ BACKGROUND_COLOR }}` | #e5fffd |
| `{{ ELEMENT_COLOR_2 }}` | #4c809a |
| `{{ ELEMENT_COLOR_3 }}` | #c7e8f0 |
## Template JSON
```json
{
"timeline": {
"fonts": [
{
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/5ef3401c-8a55-4b45-b00a-412ffc11b3f9/_LOImzDK7erRjhunIspaMgxg7oE.ttf"
},
{
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/8c24c2aa-c569-4874-8f6f-cfad23a94f4f/B50TF6xQr2TXJBnGOFME6u5OR83oRP5qkH7gOw.ttf"
},
{
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/3c8cb953-e64d-4458-9e72-bc4dd79d3a74/jizzRFVKsm4Bt9PrbSzC4KLlQUF5lRJg5j-l5PvyhfTdd4TcYMNf.ttf"
},
{
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/6c1f82ce-80c6-451e-a1f8-eb6d5df7a960/mtGh4-RGJqfMvt7P8FUr0Q1j-Hf1Bkll8g.ttf"
},
{
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/775e5f25-e174-4624-bf0b-5c4e5c335ef0/ZgNNjOFFPq_AUJD1umyS30W-Xub8zD1ObheDZb9M.ttf"
},
{
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/40c43564-0e29-4141-ac9f-959d6083709c/ga6XaxZG_G5OvCf_rt7FH3B6BHLMEdVOEoc.ttf"
},
{
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/f9a2a832-42e5-4476-8a84-b59ebbffddf5/ga6XaxZG_G5OvCf_rt7FH3B6BHLMEdVOEoc.ttf"
},
{
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/4a025b1b-4f96-49e3-943f-2a0871e89750/CHy_V_PfGVjobSBkihHWDT98RVp37w8jcJpH2Q.ttf"
},
{
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/6f5126d4-3c9a-4fa9-9bc7-a73d72851094/mtGh4-RGJqfMvt7P8FUr0Q1j-Hf1Bkll8g.ttf"
},
{
"src": "https://fonts.gstatic.com/s/didactgothic/v21/ahcfv8qz1zt6hCC5G4F_P4ASpUySp0LlcyQ.ttf"
},
{
"src": "https://fonts.gstatic.com/s/alegreyasanssc/v24/mtGh4-RGJqfMvt7P8FUr0Q1j-Hf1Nk5v9ixALYs.ttf"
}
],
"background": "#FFFFFF",
"tracks": [
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/54c81fb1-4951-43c2-8489-4a2600ee1b9e/source.png"
},
"start": 0.2,
"length": 9.8
},
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0.2,
"length": "end",
"offset": {
"x": -0.565,
"y": 0.417
},
"position": "center",
"transform": {
"rotate": {
"angle": 90
}
},
"transition": {
"in": "slideRight"
},
"width": 800,
"height": 400
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{BATHROOMS}}",
"font": {
"family": "Montserrat SemiBold",
"size": 72,
"weight": 600,
"color": "{{ S1_FONT_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
}
},
"start": 0.5,
"length": "end",
"offset": {
"x": 0.245,
"y": -0.32
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"width": 100,
"height": 100
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{BEDROOMS}}",
"font": {
"family": "Montserrat SemiBold",
"size": 72,
"weight": 600,
"color": "{{ S1_FONT_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "center",
"vertical": "middle"
}
},
"start": 0.4,
"length": "end",
"offset": {
"x": 0.245,
"y": -0.268
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"width": 100,
"height": 100
}
]
},
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/cde8edd0-6ad2-44b1-8446-254d25bb1ed5/source.png"
},
"start": 0.4,
"length": 9.6
},
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0.4,
"length": "end",
"offset": {
"x": 0.349,
"y": -0.268
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"width": 90,
"height": 90
}
]
},
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/9c330fbd-cbd0-409b-b710-339993987e53/source.png"
},
"start": 0.5,
"length": 9.5
},
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0.5,
"length": "end",
"offset": {
"x": 0.349,
"y": -0.325
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"width": 80,
"height": 80
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{ADDRESS}}",
"font": {
"family": "Didact Gothic",
"size": 72,
"weight": 400,
"color": "{{ S1_FONT_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
},
"animation": {
"preset": "typewriter",
"style": "word",
"direction": "right"
}
},
"start": 0.6,
"length": "end",
"offset": {
"x": -0.185,
"y": -0.315
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 500,
"height": 261
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{SIZE}}",
"font": {
"family": "Didact Gothic",
"size": 72,
"weight": 400,
"color": "{{ S1_FONT_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "right",
"vertical": "middle"
}
},
"start": 0.3,
"length": "end",
"offset": {
"x": 0.255,
"y": -0.196
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"width": 400,
"height": 200
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{AMOUNT}}",
"font": {
"family": "Didact Gothic",
"size": 113,
"weight": 400,
"color": "{{ S2_FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
}
},
"start": 0.5,
"length": "end",
"offset": {
"x": -0.245,
"y": -0.209
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 400,
"height": 136
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{S1_TITLE}}",
"font": {
"family": "Didact Gothic",
"size": 44,
"weight": 400,
"color": "{{ S2_FONT_COLOR_2 }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "left",
"vertical": "middle"
}
},
"start": 0.4,
"length": "end",
"offset": {
"x": -0.284,
"y": -0.164
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 300,
"height": 60
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": "{{BRAND_NAME}}",
"font": {
"family": "Montserrat SemiBold",
"size": 54,
"weight": 600,
"color": "{{ S1_FONT_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "right",
"vertical": "middle"
},
"animation": {
"preset": "slideIn",
"direction": "left",
"style": "word"
}
},
"start": 0,
"length": "end",
"offset": {
"x": 0.139,
"y": 0.386
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"width": 650,
"height": 135
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0,
"length": "end",
"offset": {
"x": -0.334,
"y": 0.535
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 300,
"height": 300
},
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/81386b31-622b-42e6-8d5c-91ea7e906caa/source.png"
},
"start": 0,
"length": 10
}
]
},
{
"clips": [
{
"length": "end",
"asset": {
"type": "video",
"src": "{{ VIDEO_SRC }}",
"volume": 0
},
"start": 0.2,
"scale": 1,
"offset": {
"x": 0.16658663719000477,
"y": 0.07859908040364588
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"fit": "contain",
"width": 1165,
"height": 662
}
]
},
{
"clips": [
{
"asset": {
"type": "rich-text",
"text": " {{TITLE}}",
"font": {
"family": "Alegreya Sans SC",
"size": 121,
"weight": 400,
"color": "{{ S1_FONT_COLOR }}",
"opacity": 1
},
"style": {
"letterSpacing": 0,
"wordSpacing": 0,
"lineHeight": 1,
"textTransform": "none",
"textDecoration": "none"
},
"align": {
"horizontal": "right",
"vertical": "middle"
},
"animation": {
"preset": "slideIn",
"style": "word",
"direction": "left"
}
},
"start": 0.1,
"length": "end",
"offset": {
"x": 0,
"y": 0.326
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"width": 950,
"height": 150
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0.3,
"length": "end",
"offset": {
"x": -0.231,
"y": -0.196
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 600,
"height": 175
}
]
},
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/c51b9bd3-2f4d-406a-a6e8-3f26edfdcddb/source.png"
},
"start": 0.6,
"length": 9.4
},
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0.6,
"length": "end",
"offset": {
"x": 0.222,
"y": -0.5
},
"position": "center",
"transition": {
"in": "slideLeft"
},
"width": 922,
"height": 535
}
]
},
{
"clips": [
{
"asset": {
"type": "luma",
"src": "https://templates.shotstack.io/live-smart-beautiful-modern-home/114ae53f-c4f3-4547-832a-71252293c3a4/source.png"
},
"start": 0.1,
"length": 9.9
},
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0.1,
"length": "end",
"offset": {
"x": -0.324,
"y": 0.36
},
"position": "center",
"transition": {
"in": "slideRight"
},
"width": 300,
"height": 300
}
]
},
{
"clips": [
{
"asset": {
"type": "svg",
"src": ""
},
"start": 0,
"length": 10,
"width": 1080,
"height": 1920
}
]
}
]
},
"output": {
"format": "mp4",
"fps": 25,
"size": {
"width": 1080,
"height": 1920
},
"destinations": [
{
"provider": "shotstack"
}
]
},
"merge": [
{
"find": "BRAND_NAME",
"replace": "Newyork Real Estate"
},
{
"find": "TITLE",
"replace": "House for Sale"
},
{
"find": "S1_TITLE",
"replace": "Start from"
},
{
"find": "AMOUNT",
"replace": "$15,000"
},
{
"find": "ADDRESS",
"replace": "123 Anywhere ST., Any City, ST 12345"
},
{
"find": "SIZE",
"replace": "2,500 Sqft"
},
{
"find": "BEDROOMS",
"replace": "3"
},
{
"find": "BATHROOMS",
"replace": "2"
},
{
"find": "VIDEO_SRC",
"replace": "https://templates.shotstack.io/live-smart-beautiful-modern-home/42159a49-70d4-4f8a-acbe-9f49d547ab2d/source.mp4"
},
{
"find": "S1_FONT_COLOR",
"replace": "#124b5e"
},
{
"find": "S2_FONT_COLOR_2",
"replace": "#ffffff"
},
{
"find": "BACKGROUND_COLOR",
"replace": "#e5fffd"
},
{
"find": "ELEMENT_COLOR_2",
"replace": "#4c809a"
},
{
"find": "ELEMENT_COLOR_3",
"replace": "#c7e8f0"
}
]
}
```
## 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