A short Node script reads a CSV and sends ReelSDK one POST /v1/slideshow per row. A 10-second personalized video with voiceover and captions costs about $0.013, and a 10-row sheet is done in just over a minute.
Generate hundreds of personalized videos from a spreadsheet
Each request carries the row's name and photos in its body. A ReelSDK key runs 3 jobs at once and 500 per UTC day, so a 500-row sheet takes about an hour and costs about $6.40.
Use casesUpdated
The request
POST /v1/slideshow
Turn every row of a spreadsheet into its own personalized video with a short Node script and one POST per row.
curl "https://api.reelsdk.com/v1/slideshow?wait=300" \
-H "Authorization: Bearer $REELSDK_KEY" \
--json '{
"images": [
"https://api.reelsdk.com/f/lib/in/trips/kyoto-1.jpg",
"https://api.reelsdk.com/f/lib/in/trips/kyoto-2.jpg",
"https://api.reelsdk.com/f/lib/in/trips/kyoto-3.jpg"
],
"size": "9:16",
"voiceover": {
"text": "Maya, your trip to Kyoto is booked. Here is a first look at what is waiting for you. Your full plan arrives a week before you fly. Have a wonderful trip!",
"voice": "luna"
},
"music": {
"url": "https://api.reelsdk.com/f/lib/music/upbeat/happy-dance.mp3",
"volume": 0.15
},
"captions": "bold"
}'row 3 Sofia: succeeded job_9snvpyk8b6p24eq8bgu1 9.733 s
row 2 Liam: succeeded job_12c4kzp2rxenih5tqvrb 11.7 s
row 1 Maya: succeeded job_tsnq5owa4y4ehvt6qugx 10.867 s
row 4 Noah: succeeded job_9ijarv6wk2srclis9rxv 9.833 s
row 5 Ava: succeeded job_evd2rvabj1cb05qiahfv 9.967 s
row 6 Lucas: succeeded job_uvlgit1yn08hgbcq98cg 10.333 s
row 7 Emma: succeeded job_g9egl6omzptcxru39ahq 9.9 s
row 9 Zoe: succeeded job_4c1mp6uisn75gcdef5y3 9.7 s
row 8 Mateo: succeeded job_f60gtdbyc7zmkvx3cuiu 9.733 s
row 10 Ethan: succeeded job_8oukguc80z94nxls56pw 10.233 s
10 rows in 73.4 s
The sheet and the script
Export your spreadsheet as a CSV file. In our trip bookings run, each of the 10 rows in trips.csv has an id, a name, a city and a photos column containing space-separated image URLs. A Node script with no dependencies reads trips.csv and builds one POST /v1/slideshow request body per row, putting the traveler's name and city straight into the voiceover text.
The script reads REELSDK_KEY from the environment and sends the requests using 3 workers. It waits for each job to finish, then writes results.csv with the job id, status and video link for every row.
import { readFile, writeFile } from "node:fs/promises";
const API = "https://api.reelsdk.com";
const KEY = process.env.REELSDK_KEY;
const PARALLEL = 3;
const MUSIC = "https://api.reelsdk.com/f/lib/music/upbeat/happy-dance.mp3";
const [header, ...lines] = (await readFile("trips.csv", "utf8")).trim().split("\n");
const columns = header.split(",");
const rows = lines.map((line) => Object.fromEntries(line.split(",").map((cell, i) => [columns[i], cell.trim()])));
const sleep = (seconds) => new Promise((resolve) => setTimeout(resolve, seconds * 1000));
async function api(path, init = {}) {
while (true) {
const res = await fetch(API + path, {
...init,
headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json", ...init.headers },
});
// Over a per-key limit we wait as long as the API tells us to
if (res.status === 429) {
await sleep(Number(res.headers.get("Retry-After") ?? 10));
continue;
}
const body = await res.json();
if (body.job) return body.job;
throw new Error(`${res.status} ${body.error.code}: ${body.error.message}`);
}
}
async function render(row) {
const spec = {
images: row.photos.split(" "),
size: "9:16",
voiceover: {
text: `${row.name}, your trip to ${row.city} is booked. Here is a first look at what is waiting for you. Your full plan arrives a week before you fly. Have a wonderful trip!`,
voice: "luna",
},
music: { url: MUSIC, volume: 0.15 },
captions: "bold",
};
// The idempotency key makes a rerun pick up the same job instead of paying for it twice
let job = await api("/v1/slideshow", {
method: "POST",
headers: { "Idempotency-Key": `trips-november-row-${row.id}` },
body: JSON.stringify(spec),
});
while (job.status === "queued" || job.status === "running") job = await api(`/v1/jobs/${job.id}?wait=60`);
return job;
}
const started = Date.now();
const results = [];
let next = 0;
async function worker() {
while (next < rows.length) {
const row = rows[next++];
try {
const job = await render(row);
results.push({ row, job });
console.log(`row ${row.id} ${row.name}: ${job.status} ${job.id} ${job.duration_s} s`);
} catch (error) {
results.push({ row, error: String(error) });
console.log(`row ${row.id} ${row.name}: ${error}`);
}
}
}
await Promise.all(Array.from({ length: PARALLEL }, worker));
const csv = [
"id,name,job,status,video,cost_usd",
...results.map(({ row, job, error }) =>
[row.id, row.name, job?.id ?? "", job?.status ?? error, job?.outputs.video ?? "", job?.cost_usd ?? ""].join(","),
),
];
await writeFile("results.csv", csv.join("\n") + "\n");
console.log(`${results.length} rows in ${((Date.now() - started) / 1000).toFixed(1)} s`);
id,name,city,photos
1,Maya,Kyoto,https://api.reelsdk.com/f/lib/in/trips/kyoto-1.jpg https://api.reelsdk.com/f/lib/in/trips/kyoto-2.jpg https://api.reelsdk.com/f/lib/in/trips/kyoto-3.jpg
2,Liam,Tokyo,https://api.reelsdk.com/f/lib/in/trips/tokyo-1.jpg https://api.reelsdk.com/f/lib/in/trips/tokyo-2.jpg https://api.reelsdk.com/f/lib/in/trips/tokyo-3.jpg
3,Sofia,Rome,https://api.reelsdk.com/f/lib/in/trips/rome-1.jpg https://api.reelsdk.com/f/lib/in/trips/rome-2.jpg https://api.reelsdk.com/f/lib/in/trips/rome-3.jpg
4,Noah,Bali,https://api.reelsdk.com/f/lib/in/trips/bali-1.jpg https://api.reelsdk.com/f/lib/in/trips/bali-2.jpg https://api.reelsdk.com/f/lib/in/trips/bali-3.jpg
5,Ava,Paris,https://api.reelsdk.com/f/lib/in/trips/paris-1.jpg https://api.reelsdk.com/f/lib/in/trips/paris-2.jpg https://api.reelsdk.com/f/lib/in/trips/london.jpg
6,Lucas,Lisbon,https://api.reelsdk.com/f/lib/in/trips/lisbon.jpg https://api.reelsdk.com/f/lib/in/trips/porto.jpg
7,Emma,Mount Fuji,https://api.reelsdk.com/f/lib/in/trips/fuji.jpg https://api.reelsdk.com/f/lib/in/trips/tokyo-4.jpg https://api.reelsdk.com/f/lib/in/trips/kyoto-2.jpg
8,Mateo,Venice,https://api.reelsdk.com/f/lib/in/trips/venice.jpg https://api.reelsdk.com/f/lib/in/trips/rome-1.jpg https://api.reelsdk.com/f/lib/in/trips/rome-2.jpg
9,Zoe,Tokyo,https://api.reelsdk.com/f/lib/in/trips/tokyo-4.jpg https://api.reelsdk.com/f/lib/in/trips/tokyo-2.jpg https://api.reelsdk.com/f/lib/in/trips/fuji.jpg
10,Ethan,Kyoto,https://api.reelsdk.com/f/lib/in/trips/kyoto-3.jpg https://api.reelsdk.com/f/lib/in/trips/kyoto-1.jpg https://api.reelsdk.com/f/lib/in/trips/fuji.jpg
At a glance
The 10 rows, as rendered
Every row is its own job; cost is that job's usage at the published prices.
| Row | Video | Cost |
|---|---|---|
| Maya, Kyoto | 11 s | $0.013 |
| Liam, Tokyo | 12 s | $0.014 |
| Sofia, Rome | 10 s | $0.013 |
| Noah, Bali | 10 s | $0.013 |
| Ava, Paris | 10 s | $0.013 |
| Lucas, Lisbon | 10 s | $0.013 |
| Emma, Mount Fuji | 10 s | $0.013 |
| Mateo, Venice | 10 s | $0.013 |
| Zoe, Tokyo | 10 s | $0.012 |
| Ethan, Kyoto | 10 s | $0.013 |
Sources: Sample batch results, ReelSDK pricing, checked November 2026.
Three at a time, and what happens past that
An API key can run 3 jobs at once and up to 500 jobs per UTC day, so the script runs 3 workers in parallel. If a request goes over a limit, the API returns 429 RATE_LIMITED with a Retry-After header, and the script sleeps for that duration before trying again.
Our 10 rows were done in just over a minute at about 1.3 cents per video, so at that pace 500 rows take about an hour and cost about $6.40. The cost_usd column in results.csv fills in automatically when you use a key on a billed account.
Retries without duplicates
Every request sends an Idempotency-Key header built from the row id, like trips-november-row-1. Keys of 8 to 128 letters, digits, -, _, . or : are replayed for 24 h, so if the script crashes and you run it again, the API returns the jobs that already exist instead of rendering and billing those rows twice.
If you don't want the script waiting on each job, pass a webhook_url in the request body instead. ReelSDK tries your endpoint up to 6 times over about 7 h, with a 15 s timeout per attempt. You can read the full details in jobs docs, webhooks and pricing.
What it costs
What the 10 videos cost
- Video, 102 s at $0.03 per minute
- $0.0510
- Voiceover, 1,537 characters at $0.05 per 1,000
- $0.0769
- Total
- $0.128
About 1.3 cents per video. Each job is billed on its own usage; a failed job costs nothing.
Limits
What one request takes
- Concurrent jobs
- 3 per key
- Jobs per day
- 500 per key
- Idempotency key
- 8 to 128 characters (letters, digits, - _ . :), replayed for 24 h
- Webhooks
- Up to 6 attempts over about 7 h
- Images
- 1 to 100 per video
- Seconds per image
- 0.5 to 60
- Voiceover text
- Up to 10,000 characters
- Output retention
- 7 days
How it works
From request to file
Export the sheet as CSV
Set up one row per video with a column for each value that changes, like
name,cityorphotosURLs.Map the columns to the request
Have the script put each column's value into the
POST /v1/slideshowrequest body for fields likeimages, voiceover text andmusic.Run the script
Set
REELSDK_KEYin your environment and run the script with Node to keep 3 jobs running at once and wait out any429responses.Collect results.csv
Read the
job,statusandvideocolumns inresults.csv, and copy the videos out since output links last 7 days.
FAQ
Questions, answered
How many videos can I make per day?
Each key can run 500 jobs per UTC day, with 3 jobs running at once. At the pace of our test batch, 500 rows take about an hour.
What did the 10 videos cost?
About 13 cents for all 10, or about 1.3 cents each. The voiceover is most of it: $0.05 per 1,000 characters, against $0.03 per minute for the video itself.
What happens if the script stops halfway?
Just run it again. Each row sends the same Idempotency-Key, which is replayed for 24 h, so finished rows return the existing job and aren't billed twice.
Can I get notified instead of polling?
Yes, add a webhook_url to each request. ReelSDK sends a signed POST when the job finishes and tries up to 6 times in all, over about 7 h, until your endpoint answers with a 2xx.
Can each row use different settings?
Yes, any field in the request can come from a spreadsheet column, including photos, voiceover text, voice, music, captions or size.
- Real estate listing videosTurn landscape listing photos into a vertical reel with a voiceover, music and captions, without cropping a single photo.
- Car dealer inventory videosAuto-generate a vertical video with voiceover and captions for every vehicle in your inventory from its listing photos.
- Product videos from photosTurn ecommerce product photos into a short video with slide transitions and music, in any feed shape, with one POST.
- Jobs: statuses, waiting and pollingHow ReelSDK jobs work: 4 statuses, 12 job fields, GET /v1/jobs/{id}, waits of up to 300 s with ?wait or Prefer, 202 with Retry-After: 5 and polling code in curl, JavaScript and Python.
- Webhooks: delivery, signatures and retriesAdd webhook_url to any ReelSDK job and get the finished job POSTed to you, signed with HMAC-SHA256. Up to 6 attempts over about 7 hours, a 300 s signature window and tested verify code for Node, Deno and Python.
Ready to build?
Ship video from your app today
Your first $0.50 is free, and one key covers every endpoint.
