[Integrations](https://spiral.ai/integrations) › [VS Code](https://spiral.ai/integrations/vscode) › [VEED Subtitles](https://spiral.ai/integrations/vscode/veed-subtitles)

# How to Use VEED Subtitles in VS Code

VEED Subtitles adds styled captions to recorded videos, from social clips to long recordings. It returns an MP4 with captions burned into the frames, making it useful when you need a captioned video rather than a transcript.

|  |  |
| --- | --- |
| Model | VEED Subtitles |
| Available through | fal |
| Category | Video |
| Price | $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. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with VEED Subtitles in VS Code

- Use VEED Subtitles to caption the demo recording in this project, using product spellings from the README as vocabulary guidance.
- Use VEED Subtitles to burn the project's approved SRT into its matching tutorial video.
- Use VEED Subtitles on the release walkthrough, using the project's brand font and caption colors.
- Use VEED Subtitles to caption the 30-minute 1080p training recording in the project.
- Use VEED Subtitles to render the Spanish SRT in the project onto the matching demo video.

## How to set up VEED Subtitles in VS Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to VS Code on the console's Agents & MCP page, or run:

```bash
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
```

2. **Sign in**: VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

### Use the Spiral skill

1. **Send VS Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run VEED Subtitles**: One request; the result comes back by polling or a webhook.

```bash
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"
    }
  }'
```

Then paste one of the prompts above: VS Code finds VEED Subtitles on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/vscode

## VEED Subtitles tools and prices

- [VEED Subtitles](https://spiral.ai/tools/fal/veed/subtitles) (fal): $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.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| language | 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 | 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_url |  | — | Upload or paste a URL to your .srt subtitles file. When provided, transcription is skipped. |
| srt_content |  | — | Paste raw SRT subtitle text. Alternative to srt_file_url. When provided, transcription is skipped. |
| vocabulary |  | — | 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 |  | — | 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. |

## What can you do with VEED Subtitles in VS Code?

Turn project demo recordings into captioned videos with VEED Subtitles. Use the project's terminology and approved subtitles to guide the result.

### Caption social clips

Add visible dialogue captions to vertical interview clips, Reels, or Shorts.

### Prepare captioned product demos

Caption a recorded walkthrough and supply vocabulary guidance for product names.

### Style customer testimonials

Apply consistent caption fonts and colors across recorded customer stories.

### Caption recorded lessons

Add captions to lessons and training recordings within the documented duration limits.

### Render approved subtitles

Burn a reviewed SRT into its matching video when approved wording matters.

### Produce localized video copies

Render separately prepared, translated SRT captions into copies of the same video.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All VS Code guides](https://spiral.ai/integrations/vscode)

## VEED Subtitles in other agents

- [Amp](https://spiral.ai/integrations/amp/veed-subtitles)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/veed-subtitles)
- [Claude](https://spiral.ai/integrations/claude-desktop/veed-subtitles)
- [Claude Code](https://spiral.ai/integrations/claude-code/veed-subtitles)
- [Cline](https://spiral.ai/integrations/cline/veed-subtitles)
- [Codex](https://spiral.ai/integrations/codex/veed-subtitles)
- [Cursor](https://spiral.ai/integrations/cursor/veed-subtitles)
- [Devin](https://spiral.ai/integrations/devin/veed-subtitles)
- [dots](https://spiral.ai/integrations/dots/veed-subtitles)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/veed-subtitles)
- [Gemini](https://spiral.ai/integrations/gemini/veed-subtitles)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/veed-subtitles)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/veed-subtitles)
- [goose](https://spiral.ai/integrations/goose/veed-subtitles)
- [Grok](https://spiral.ai/integrations/grok/veed-subtitles)
- [Grok Build](https://spiral.ai/integrations/grok-build/veed-subtitles)
- [Hermes](https://spiral.ai/integrations/hermes/veed-subtitles)
- [Instinct](https://spiral.ai/integrations/instinct/veed-subtitles)
- [Manus](https://spiral.ai/integrations/manus/veed-subtitles)
- [Muse](https://spiral.ai/integrations/muse/veed-subtitles)
- [Muse Code](https://spiral.ai/integrations/muse-code/veed-subtitles)
- [n8n](https://spiral.ai/integrations/n8n/veed-subtitles)
- [Notion](https://spiral.ai/integrations/notion/veed-subtitles)
- [OpenClaw](https://spiral.ai/integrations/openclaw/veed-subtitles)
- [opencode](https://spiral.ai/integrations/opencode/veed-subtitles)
- [Perplexity](https://spiral.ai/integrations/perplexity/veed-subtitles)
- [Raycast](https://spiral.ai/integrations/raycast/veed-subtitles)
- [Windsurf](https://spiral.ai/integrations/windsurf/veed-subtitles)
- [Zapier](https://spiral.ai/integrations/zapier/veed-subtitles)

## More VS Code guides

- [VEED Lipsync](https://spiral.ai/integrations/vscode/veed-lipsync)
- [VEED Video Background Removal](https://spiral.ai/integrations/vscode/veed-video-background-removal)
- [VEED Fabric 1.0](https://spiral.ai/integrations/vscode/veed-fabric-1-0)
- [VEED Video Background Removal Fast](https://spiral.ai/integrations/vscode/veed-video-background-removal-fast)
- [VEED Dubbing Standard](https://spiral.ai/integrations/vscode/veed-dubbing-standard)
- [VOID Video Inpainting](https://spiral.ai/integrations/vscode/void-video-inpainting)

## Questions about VEED Subtitles in VS Code

**Can VS Code use VEED Subtitles?**

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run VEED Subtitles like any built-in tool.

**How much does VEED Subtitles cost in VS Code?**

$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 from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.

**Do I need a fal account to use VEED Subtitles in VS Code?**

No. Spiral runs VEED Subtitles on its own fal account. You sign in to Spiral once and never paste a key.

**How long does it take to set up VEED Subtitles in VS Code?**

About two minutes: add the hosted server, then sign in.

**Does VS Code wait while VEED Subtitles runs?**

VEED Subtitles runs in the background. VS Code starts the run, checks on it and gives you the video when it's ready.

**Does VEED Subtitles return a video or a transcript?**

It returns an MP4 with captions permanently rendered into the frames. Choose it when you need the captioned video itself.

**How long can a video be?**

VEED documents a maximum of two hours at 1080p or below, and one hour above 1080p. Split longer recordings before captioning them.

**Which spoken languages does VEED Subtitles support?**

It supports over 100 languages, including English, Spanish, French, German, Portuguese, and Japanese.

**How should I handle product names and technical terms?**

Provide vocabulary guidance for names and jargon that transcription might misspell. Review those terms before publishing.

**What if I need exact caption wording?**

Use a reviewed SRT to replace automatic transcription. This is useful when the transcript needs corrections or you already have translated captions.

