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 first of 10 rows: Maya's trip to Kyoto, an 11-second video with her name in the voiceover.Input: trips.csv row 1 photo

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.

terminalTry it
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"
  }'
output
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.

batch.mjsTry it
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`);
trips.csv
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.

The 10 rows, as rendered
RowVideoCost
Maya, Kyoto11 s$0.013
Liam, Tokyo12 s$0.014
Sofia, Rome10 s$0.013
Noah, Bali10 s$0.013
Ava, Paris10 s$0.013
Lucas, Lisbon10 s$0.013
Emma, Mount Fuji10 s$0.013
Mateo, Venice10 s$0.013
Zoe, Tokyo10 s$0.012
Ethan, Kyoto10 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

  1. Export the sheet as CSV

    Set up one row per video with a column for each value that changes, like name, city or photos URLs.

  2. Map the columns to the request

    Have the script put each column's value into the POST /v1/slideshow request body for fields like images, voiceover text and music.

  3. Run the script

    Set REELSDK_KEY in your environment and run the script with Node to keep 3 jobs running at once and wait out any 429 responses.

  4. Collect results.csv

    Read the job, status and video columns in results.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.

Ready to build?

Ship video from your app today

Your first $0.50 is free, and one key covers every endpoint.

Moonlit lake with a lit cabin under the mountains