Experience Shotstack for yourself,
with no risk, and generate your first
video in 5 minutes.
Unlimited developer sandbox
No credit card required
{
"timeline": {
"fonts": [
{
"src": "https://templates.shotstack.io/basic/asset/font/barlow-extrabold.ttf"
},
{
"src": "https://templates.shotstack.io/basic/asset/font/barlow-extralight.ttf"
},
{
"src": "https://templates.shotstack.io/basic/asset/font/barlow-regular.ttf"
}
],
"soundtrack": {
"src": "https://shotstack-assets.s3-ap-southeast-2.amazonaws.com/music/freepd/fireworks.mp3",
"effect": "fadeOut"
},
"background": "#ffffff",
"tracks": [
{
"clips": [
{
"asset": {
"type": "image",
"src": "https://shotstack-assets.s3.ap-southeast-2.amazonaws.com/logos/real-estate-black.png"
},
"start": 1.5,
"length": 3.5,
"fit": "none",
"scale": 0.8,
"offset": {
"y": 0.2
},
"transition": {
"in": "fade"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "html",
"html": "<p>Main Heading</p>",
"css": "p { font-family: 'Barlow ExtraBold'; color: #ffe512; font-size: 80px; }",
"width": 1000,
"height": 90
},
"start": 1.9,
"length": 3.1,
"offset": {
"y": -0.05
},
"transition": {
"in": "slideRight"
}
},
{
"asset": {
"type": "html",
"html": "<p>Subheading and more info</p>",
"css": "p { font-family: 'Barlow'; color: #333333; font-size: 60px; }",
"width": 1000,
"height": 200,
"position": "top"
},
"start": 2.1,
"length": 2.9,
"offset": {
"y": -0.19
},
"transition": {
"in": "slideRight"
}
},
{
"asset": {
"type": "html",
"html": "<p><b>Tel:</b> 999-999-9999</p>",
"css": "p { font-family: 'Barlow ExtraLight'; color: #333333; font-size: 40px; } ",
"width": 1000,
"height": 50
},
"start": 2.3,
"length": 2.7,
"offset": {
"y": -0.36
},
"transition": {
"in": "fade"
}
}
]
},
{
"clips": [
{
"asset": {
"type": "html",
"html": "<p> </p>",
"width": 380,
"height": 1280,
"background": "#ffe512"
},
"start": 0.0,
"length": 1.2,
"position": "left",
"offset": {
"x": -0.1,
"y": 0.1
},
"transform": {
"rotate": {
"angle": 10
}
},
"transition": {
"out": "carouselUpSlow"
}
},
{
"asset": {
"type": "html",
"html": "<p> </p>",
"width": 380,
"height": 1280,
"background": "#ffe512"
},
"start": 0.0,
"length": 1.4,
"position": "left",
"offset": {
"x": 0.1,
"y": 0.1
},
"transform": {
"rotate": {
"angle": 10
}
},
"transition": {
"out": "carouselDownSlow"
}
},
{
"asset": {
"type": "html",
"html": "<p> </p>",
"width": 380,
"height": 1280,
"background": "#ffe512"
},
"start": 0.0,
"length": 1.6,
"position": "left",
"offset": {
"x": 0.3,
"y": 0.1
},
"transform": {
"rotate": {
"angle": 10
}
},
"transition": {
"out": "carouselUpSlow"
}
},
{
"asset": {
"type": "html",
"html": "<p> </p>",
"width": 380,
"height": 1280,
"background": "#ffe512"
},
"start": 0.0,
"length": 1.8,
"position": "left",
"offset": {
"x": 0.5,
"y": 0.1
},
"transform": {
"rotate": {
"angle": 10
}
},
"transition": {
"out": "carouselDownSlow"
}
},
{
"asset": {
"type": "html",
"html": "<p> </p>",
"width": 380,
"height": 1280,
"background": "#ffe512"
},
"start": 0.0,
"length": 2,
"position": "left",
"offset": {
"x": 0.7,
"y": 0.1
},
"transform": {
"rotate": {
"angle": 10
}
},
"transition": {
"out": "carouselUpSlow"
}
},
{
"asset": {
"type": "html",
"html": "<p> </p>",
"width": 380,
"height": 1280,
"background": "#ffe512"
},
"start": 0.0,
"length": 2.2,
"position": "left",
"offset": {
"x": 0.9,
"y": 0.1
},
"transform": {
"rotate": {
"angle": 10
}
},
"transition": {
"out": "carouselDownSlow"
}
}
]
}
]
},
"output": {
"format": "gif",
"resolution": "1080"
}
}Diagonal bars slide off the screen to reveal a white background that then displays text and logo.
No account needed until you render.
Render with your AI assistant
Add the Shotstack MCP server to your editor, then paste the prompt
| Output | GIF |
|---|---|
| Size | 1920 × 1080 (16:9) |
| Length | 5s |
| Frame rate | default (25 fps) |
| Tracks / clips | 3 / 10 |
| Assets used | 9 html, 1 image |
| Soundtrack | yes |
| Merge fields | none (edit the JSON) |
Swap these in the JSON:
To drive it from data, turn any value into a {{ PLACEHOLDER }} merge field.
Save the JSON above as template.json, then render in the free sandbox:
# 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"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);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"))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 --watchSandbox renders are free and watermarked. Production: the v1 endpoint and key. SDKs
One render is a demo. A video for every row of your data is the workflow.
Paste into Claude, ChatGPT or Cursor — your AI assistant builds the workflow around your data.
Node.js, one render per CSV row, wired to this template. Setup steps in the header.
Guides: Bulk-create from a CSV · Webhooks · Templates endpoint · Render your first video
AI assistants: Markdown () · · · CLI skill: SKILL.md () · MCP server
Replace the asset URLs in the JSON with your own files and adjust text, timing or effects on each clip. To generate many variations from data, turn the values you change into merge fields ({{ PLACEHOLDER }}) and pass a merge array with each request.
Yes. This template renders 1920×1080 by default. Set output.resolution to "1080" or output.size to a larger 16:9 size in the JSON; the layout scales with it.
Yes. The template uses 1 image; replace each image asset's src with a public URL of your own file (JPG, PNG or WebP). Keep the timing and effects, or adjust them per clip.
Edit the text on each text asset in the JSON. Fonts come from the timeline fonts list or the asset's font family; add your own font file URL to timeline.fonts to use a brand typeface.
Unlimited developer sandbox
No credit card required
