{
"timeline": {
"background": "#000000",
"tracks": [
{
"clips": [
{
"length": "end",
"asset": {
"type": "caption",
"src": "alias://VOICEOVER",
"background": {
"color": "#ee00ff",
"padding": 22,
"borderRadius": 6
},
"font": {
"size": "36"
}
},
"start": 0
}
]
},
{
"clips": [
{
"asset": {
"type": "text",
"text": "{{ HEADLINE }}",
"alignment": {
"horizontal": "center",
"vertical": "center"
},
"font": {
"color": "#000000",
"family": "Montserrat ExtraBold",
"size": "60",
"lineHeight": 1
},
"width": 454,
"height": 200
},
"start": 0,
"length": "auto",
"offset": {
"x": 0,
"y": 0.334
},
"position": "center",
"fit": "none",
"scale": 1,
"transition": {
"in": "wipeLeft",
"out": "wipeLeft"
}
}
]
},
{
"clips": [
{
"length": "auto",
"asset": {
"type": "image",
"src": "https://templates.shotstack.io/automated-tiktok-video-science-facts/6b79fc8d-198f-47cc-8c00-19e9343dc8ac.png"
},
"start": 0,
"scale": 0.2,
"offset": {
"x": 0,
"y": 0.334
},
"position": "center",
"transition": {
"out": "wipeLeft",
"in": "wipeLeft"
},
"alias": "VOICEOVER"
}
]
},
{
"clips": [
{
"length": "auto",
"asset": {
"voice": "Amy",
"text": "{{ VOICEOVER }}",
"type": "text-to-speech"
},
"start": 0,
"alias": "VOICEOVER"
}
]
},
{
"clips": [
{
"length": 5,
"asset": {
"width": "768",
"height": "1280",
"type": "text-to-image",
"prompt": "{{ IMAGE_1_PROMPT }}"
},
"start": "auto",
"fit": "cover",
"transition": {
"out": "fade"
},
"effect": "zoomInSlow"
},
{
"length": 5,
"asset": {
"width": "768",
"height": "1280",
"type": "text-to-image",
"prompt": "{{ IMAGE_3_PROMPT }}"
},
"start": 7.99,
"fit": "cover",
"transition": {
"in": "fade",
"out": "fade"
},
"effect": "slideRightSlow"
},
{
"length": "end",
"asset": {
"width": "768",
"height": "1280",
"type": "text-to-image",
"prompt": "{{ IMAGE_5_PROMPT }}"
},
"start": 16,
"fit": "cover",
"transition": {
"in": "fade"
},
"effect": "zoomInSlow"
}
]
},
{
"clips": [
{
"length": 5,
"asset": {
"width": "768",
"height": "1280",
"type": "text-to-image",
"prompt": "{{ IMAGE_2_PROMPT }}"
},
"start": 4,
"fit": "cover",
"transition": {
"out": "fade"
},
"effect": "slideLeft"
},
{
"length": 5,
"asset": {
"width": "768",
"height": "1280",
"type": "text-to-image",
"prompt": "{{ IMAGE_4_PROMPT }}"
},
"start": 12,
"fit": "cover",
"transition": {
"in": "fade",
"out": "fade"
},
"effect": "zoomOutSlow"
}
]
}
]
},
"output": {
"format": "mp4",
"fps": 25,
"size": {
"width": 720,
"height": 1280
}
},
"merge": [
{
"find": "VOICEOVER",
"replace": "Did you know that bananas are slightly radioactive? They contain potassium-40, a naturally occurring isotope that emits a small amount of radiation. Don\u2019t worry though, you\u2019d have to eat over 10 million bananas at once to experience any harmful effects! This phenomenon is known as the \u2018banana equivalent dose,\u2019 and it\u2019s a fun way to understand radiation in everyday life."
},
{
"find": "IMAGE_1_PROMPT",
"replace": "A perfectly peeled banana hovers gracefully above a sleek, reflective metal surface in a futuristic laboratory. Suspended just above the banana is a glowing radiation symbol, its black lines crisp and sharp against the radiant yellow center. The glossy surface of the table captures reflections of the warm orange gradient in the background, adding a sense of depth and energy to the scene. Soft, translucent bubbles float effortlessly around the banana, reflecting light and casting gentle highlights across the smooth lines of the scene. The retro-futuristic vibe, with its glossy finishes and clean, curved lines, evokes a sense of mid-century sci-fi, blending the playful imagery of the banana with the precise, scientific iconography of the radiation symbol."
},
{
"find": "IMAGE_2_PROMPT",
"replace": "A half-peeled banana floats above a shiny metal table in a laboratory setting, with a detailed potassium atom suspended within the fruit\u2019s curved form. The shiny surface of the table reflects the vibrant orange background, while the banana\u2019s yellow colors contrast against the glowing nucleus and orbiting electrons of the atom. Surrounding the banana, translucent bubbles float gently, reflecting light and adding depth to the scene. The smooth lines and retro-futuristic aesthetic, reminiscent of mid-century sci-fi illustrations, are complemented by the juxtaposition of the banana\u2019s natural form and the scientifically precise atom within."
},
{
"find": "IMAGE_3_PROMPT",
"replace": "A small stack of perfectly ripe, peeled bananas rests on a sleek metal table inside a retro-futuristic laboratory. Beside the stack, a modern, digital radiation meter floats just above the surface, its glowing screen reflecting softly on the shiny table. The background features a warm orange gradient, complemented by softly floating translucent bubbles that reflect the surrounding light. Smooth lines and a glossy finish give the scene a mid-century sci-fi aesthetic, emphasizing the playful yet precise contrast between the bananas\u2019 natural form and the scientific equipment around them."
},
{
"find": "IMAGE_4_PROMPT",
"replace": "A single, peeled banana stands upright in the center of a gleaming metal platform, floating slightly above the surface in a futuristic lab environment. Surrounding the banana, softly glowing translucent bubbles float, adding depth and reflecting the ambient light. The background is a vibrant orange gradient, seamlessly blending with the reflective surface of the platform. The scene has a retro-futuristic feel, with smooth lines and a sleek, glossy finish reminiscent of mid-century sci-fi artwork. The juxtaposition of the banana\u2019s natural form with the scientific, futuristic setting creates a whimsical yet thought-provoking contrast."
},
{
"find": "IMAGE_5_PROMPT",
"replace": "A sleek laboratory scene features a perfectly peeled banana sliced down the middle, with one half revealing a detailed potassium atom inside, complete with orbiting electrons and a glowing nucleus. The banana hovers just above a shiny, reflective table, which mirrors the vibrant orange gradient of the background. Soft, translucent bubbles float through the air, reflecting light and adding a sense of depth to the composition. The artwork\u2019s retro-futuristic aesthetic, inspired by mid-century sci-fi illustrations, emphasizes smooth lines and glossy finishes, creating a visually striking contrast between the organic banana and the scientific precision of the atom."
},
{
"find": "HEADLINE",
"replace": "Surprising Banana Fact"
}
]
}Create engaging TikTok videos with this automated template that combines historical facts with AI-generated images and voiceovers. This template allows you to easily generate videos by replacing its merge fields with fascinating insights, and accompany this with a voiceover and AI generated images. This template simplifies the process with AI-powered text-to-image and text-to-speech through Shotstack Workflows. Perfect for content creators looking to help with content creation.
No account needed until you render.
Render with your AI assistant
Add the Shotstack MCP server to your editor, then paste the prompt
| Output | MP4 |
|---|---|
| Size | 720 × 1280 (9:16) |
| Length | 17s |
| Frame rate | 25 fps |
| Tracks / clips | 6 / 9 |
| Assets used | 1 caption, 1 image, 1 text, 5 text-to-image, 1 text-to-speech |
| Soundtrack | no |
| Merge fields | 7 |
Send a merge array with your values for these fields:
| Field | Default value |
|---|---|
{{ VOICEOVER }} | Did you know that bananas are slightly radioactive? They contain potassium-40, a naturally occurring isotope that emits a small amount of radiation. Don’t worry though, you’d have to eat over 10 million bananas at once to experience any harmful effects! This phenomenon is known as the ‘banana equivalent dose,’ and it’s a fun way to understand radiation in everyday life. |
{{ IMAGE_1_PROMPT }} | A perfectly peeled banana hovers gracefully above a sleek, reflective metal surface in a futuristic laboratory. Suspended just above the banana is a glowing radiation symbol, its black lines crisp and sharp against the radiant yellow center. The glossy surface of the table captures reflections of the warm orange gradient in the background, adding a sense of depth and energy to the scene. Soft, translucent bubbles float effortlessly around the banana, reflecting light and casting gentle highlights across the smooth lines of the scene. The retro-futuristic vibe, with its glossy finishes and clean, curved lines, evokes a sense of mid-century sci-fi, blending the playful imagery of the banana with the precise, scientific iconography of the radiation symbol. |
{{ IMAGE_2_PROMPT }} | A half-peeled banana floats above a shiny metal table in a laboratory setting, with a detailed potassium atom suspended within the fruit’s curved form. The shiny surface of the table reflects the vibrant orange background, while the banana’s yellow colors contrast against the glowing nucleus and orbiting electrons of the atom. Surrounding the banana, translucent bubbles float gently, reflecting light and adding depth to the scene. The smooth lines and retro-futuristic aesthetic, reminiscent of mid-century sci-fi illustrations, are complemented by the juxtaposition of the banana’s natural form and the scientifically precise atom within. |
{{ IMAGE_3_PROMPT }} | A small stack of perfectly ripe, peeled bananas rests on a sleek metal table inside a retro-futuristic laboratory. Beside the stack, a modern, digital radiation meter floats just above the surface, its glowing screen reflecting softly on the shiny table. The background features a warm orange gradient, complemented by softly floating translucent bubbles that reflect the surrounding light. Smooth lines and a glossy finish give the scene a mid-century sci-fi aesthetic, emphasizing the playful yet precise contrast between the bananas’ natural form and the scientific equipment around them. |
{{ IMAGE_4_PROMPT }} | A single, peeled banana stands upright in the center of a gleaming metal platform, floating slightly above the surface in a futuristic lab environment. Surrounding the banana, softly glowing translucent bubbles float, adding depth and reflecting the ambient light. The background is a vibrant orange gradient, seamlessly blending with the reflective surface of the platform. The scene has a retro-futuristic feel, with smooth lines and a sleek, glossy finish reminiscent of mid-century sci-fi artwork. The juxtaposition of the banana’s natural form with the scientific, futuristic setting creates a whimsical yet thought-provoking contrast. |
{{ IMAGE_5_PROMPT }} | A sleek laboratory scene features a perfectly peeled banana sliced down the middle, with one half revealing a detailed potassium atom inside, complete with orbiting electrons and a glowing nucleus. The banana hovers just above a shiny, reflective table, which mirrors the vibrant orange gradient of the background. Soft, translucent bubbles float through the air, reflecting light and adding a sense of depth to the composition. The artwork’s retro-futuristic aesthetic, inspired by mid-century sci-fi illustrations, emphasizes smooth lines and glossy finishes, creating a visually striking contrast between the organic banana and the scientific precision of the atom. |
{{ HEADLINE }} | Surprising Banana Fact |
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
Schedule it against a topic list or feed and post a fresh short every day.
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's 7 merge fields. 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
Use the 7 merge fields listed above. Send a merge array with your own values for each field and the API swaps them in at render time, so one template can produce thousands of unique videos.
Yes. It renders vertical 720×1280 (9:16), the format those platforms expect. Change output.size or output.aspectRatio in the JSON if you also need a square or landscape cut.
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.
