VEED Subtitles
veed/subtitlesEdit 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
| Field | Kind | Default | Description |
|---|---|---|---|
video_url required | URL or file | — | Upload or paste a URL to the video you want to subtitle. |
preset required | one 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:
|
language | one 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_language | one 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 |
srt_file_url | URL or file | — | Upload or paste a URL to your .srt subtitles file. When provided, transcription is skipped. |
srt_content | text | — | Paste raw SRT subtitle text. Alternative to srt_file_url. When provided, transcription is skipped. |
vocabulary | JSON | — | 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. |
customization | JSON | — | 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.