Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable nowReleased 2026-05-11

VEED Subtitles

veed/subtitles

Edit and transform video with VEED Subtitles from fal through one Spiral API key. Adds styled, animated subtitles to a video from automatic transcription or your own SRT file, with optional translation. It runs in the background and returns video. Pay as you go, with no subscription.

Pricing

$0.13 per started minute of video, at least 1 minute ($0.26 with an animated style). Translation: $0.26 per minute. Above 1080p, every price doubles.

Limits

Runs
In the background
Returns
video
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
930 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
video_url requiredURL or file—

Upload or paste a URL to the video you want to subtitle.

preset requiredone of
glass, whisper, glide2, fusion, glide, terminal, handwritten, backdrop, backdrop2, simple, plain, beans, corpo, boo, shadeplay, casper, capri, lowkey, vinta, diego, ali, slay, kitty, hustle, karl, sprout, flex, mint, rizz, vegas
—

Each style defines fonts, colors, layout, and animation. Two tiers with different pricing:

  • Dynamic presets (2x multiplier): glass, whisper, glide2, fusion, glide, terminal, handwritten, backdrop, backdrop2. Richer, context-aware rendering that adapts to the input.
  • Basic presets (1x multiplier): simple, plain, beans, corpo, boo, shadeplay, casper, capri, lowkey, vinta, diego, ali, slay, kitty, hustle, karl, sprout, flex, mint, rizz, vegas. Fixed, lightweight styling with predictable output.
languageone of
af-ZA, am-ET, ar-AE, ar-BH, ar-DZ, ar-EG, ar-IL, ar-IQ, ar-JO, ar-KW, ar-LB, ar-MA, ar-OM, ar-PS, ar-QA, ar-SA, ar-TN, ast-ES, az-AZ, ba, bas, be-BY, bg-BG, br, bs-BA, ca-ES, ceb-PH, ckb-IQ, cs-CZ, cy-GB, da-DK, de-DE, dyu, el-GR, en-AU, en-GB, en-IN, en-NZ, en-US, eo, es-AR, es-BO, es-CL, es-CO, es-CR, es-DO, es-EC, es-ES, es-GT, es-HN, es-MX, es-NI, es-PA, es-PE, es-PR, es-PY, es-SV, es-US, es-UY, es-VE, et-EE, eu-ES, fa-IR, ff, fi-FI, fil-PH, fo, fr-CA, fr-FR, fy, ga, gd, gl-ES, ha-NG, haw, he-IL, hr-HR, hsb, ht, hu-HU, hy-AM, id-ID, ig, is-IS, it-IT, ja-JP, ja-Latn-JP, jv-ID, ka-GE, kab, kam-KE, kea-CV, kk-KZ, ko-KR, ku, ky-KG, la, lb-LU, lg, lij, ln-CD, lo-LA, lt-LT, luo-KE, lv-LV, mg, mi-NZ, mk-MK, mn-MN, ms-MY, mt-MT, nb-NO, nl-NL, nso-ZA, ny-MW, oc-FR, pl-PL, ps-AF, pt-BR, pt-PT, ro-RO, roh, ru-RU, rw-RW, sah, sk-SK, sl-SI, sm, sn-ZW, so-SO, sq-AL, sr-Latn-RS, sr-RS, srd, ss, su-ID, sv-SE, sw-KE, sw-TZ, tg-TJ, th-TH, tk, tn, tok, ton, tr-TR, ts-ZA, tt, uk-UA, umb-AO, ur-IN, ur-PK, uz-UZ, vi-VN, vro, wo-SN, xh-ZA, yi, yo-NG, yue-Hant-HK, zh, zh-HK, zh-TW, zu-ZA
—

Improves transcription accuracy, and should match the source audio (not output subtitles).

translation_languageone of
ab, ace, ach, af-ZA, ak, alz, am-ET, ar-AE, ar-BH, ar-DZ, ar-EG, ar-IL, ar-IQ, ar-JO, ar-KW, ar-LB, ar-MA, ar-OM, ar-PS, ar-QA, ar-SA, ar-TN, awa, ay, az-AZ, ban, bbc, be-BY, bem, bew, bg-BG, bho, bik, bm, bs-BA, bts, btx, bua, ca-ES, ceb-PH, cgg, chm, ckb-IQ, cnh, co, crh, crs, cs-CZ, cv, cy-GB, da-DK, de-DE, din, doi, dov, dv, dz, ee, el-GR, en-AU, en-GB, en-IN, en-NZ, en-US, eo, es-AR, es-BO, es-CL, es-CO, es-CR, es-DO, es-EC, es-ES, es-GT, es-HN, es-MX, es-NI, es-PA, es-PE, es-PR, es-PY, es-SV, es-US, es-UY, es-VE, et-EE, eu-ES, fa-IR, ff, fi-FI, fil-PH, fj, fr-CA, fr-FR, fy, ga, gaa, gd, gl-ES, gn, gom, ha-NG, haw, he-IL, hil, hmn, hr-HR, hrx, ht, hu-HU, hy-AM, id-ID, ig, ilo, is-IS, it-IT, ja-JP, ja-Latn-JP, jv-ID, ka-GE, kk-KZ, ko-KR, kri, ktu, ku, ky-KG, la, lb-LU, lg, li, lij, lmo, ln-CD, lo-LA, lt-LT, ltg, luo-KE, lus, lv-LV, mai, mak, mg, mi-NZ, min, mk-MK, mn-MN, mni-Mtei, ms-Arab, ms-MY, mt-MT, nb-NO, new, nl-NL, nr, nso-ZA, nus, ny-MW, oc-FR, om, pag, pam, pap, pl-PL, ps-AF, pt-BR, pt-PT, qu, rn, ro-RO, rom, ru-RU, rw-RW, scn, sg, shn, sk-SK, sl-SI, sm, sn-ZW, so-SO, sq-AL, sr-Latn-RS, sr-RS, ss, st, su-ID, sv-SE, sw-KE, sw-TZ, szl, tet, tg-TJ, th-TH, ti, tk, tn, tr-TR, ts-ZA, tt, ug, uk-UA, ur-IN, ur-PK, uz-UZ, vi-VN, xh-ZA, yi, yo-NG, yua, yue-Hant-HK, zh, zh-HK, zh-TW, zu-ZA
—

Translate the subtitles into this language. Omit to keep the original spoken language. If you also pass srt_content or srt_file_url, set language to its source language for the most reliable translation.

srt_file_urlURL or file—

Upload or paste a URL to your .srt subtitles file. When provided, transcription is skipped.

srt_contenttext—

Paste raw SRT subtitle text. Alternative to srt_file_url. When provided, transcription is skipped.

vocabularyJSON—

Optional list of terms to help auto-transcription correctly recognise brand names and domain jargon that providers commonly mis-spell (e.g. "VEED" → "vid"). Ignored when srt_content / srt_file_url is set.

customizationJSON—

Optional preset overrides: vertical position, shadow intensity, and per-tier text styling (font, weight, hex colour) for each word-importance tier. Any omitted field keeps the preset's default.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "veed/subtitles",
    "input": {
      "video_url": "https://v3b.fal.media/files/b/0a967ce5/iARc_J0kLN9OEmiXnxT3l_substyle-example-input.mp4",
      "preset": "glass"
    }
  }'

Frequently asked questions

How much does VEED Subtitles cost?

$0.13 per started minute of video, at least 1 minute ($0.26 with an animated style). Translation: $0.26 per minute. Above 1080p, every price doubles. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use VEED Subtitles through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "veed/subtitles"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use VEED Subtitles?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use VEED Subtitles?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.