How to Use Sync React-1 in VS Code
Sync React-1 changes dialogue and emotional delivery in existing footage, including facial expressions and head motion. Use it for performance edits in clips up to 15 seconds, with one clearly visible speaker.
Prompts to try with Sync React-1 in VS Code
Copy an example into VS Code, or ask in your own words.
Use Sync React-1 to revise assets/presenter.mp4 with assets/new-intro.wav. Use the first 10 seconds of each, keep one clearly visible speaker, and change facial expressions without adding head motion.
Use Sync React-1 on the 8-second character shot in assets/scene.mp4 with assets/dialogue.wav. Make the delivery sad and include head movement; save the result beside the source for review.
Use Sync React-1 to make neutral and happy performance tests from assets/ad-shot.mp4 and assets/ad-line.wav. Keep both inputs under 15 seconds and use face mode for both tests.
Use Sync React-1 to dub assets/welcome.mp4 with the prepared Spanish recording in assets/welcome-es.wav. Use a 12-second shot with one visible presenter and retain the existing head motion.
Use Sync React-1 to revise the 10-second generated character clip in assets/character.mp4 with assets/replacement.wav. Include facial expressions and head movement, then add the result to our video review page.
How to set up Sync React-1 in VS Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to VS Code on the console's Agents & MCP page, or run:
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}' - 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
- Send VS Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Sync React-1
One request; the result comes back by polling or a webhook.
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": "fal-ai/sync-lipsync/react-1", "input": { "video_url": "https://storage.googleapis.com/falserverless/example_inputs/react_1/input.mp4", "audio_url": "https://storage.googleapis.com/falserverless/example_inputs/react_1/input.mp3", "emotion": "happy" } }'
Then paste one of the prompts above: VS Code finds Sync React-1 on Spiral, shows the price and runs it.
Sync React-1 providers and prices
Spiral runs Sync React-1 through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Sync React-1 works from your video URL and audio URL. Ask VS Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Emotion | happy, sad, angry, disgusted, surprised, or neutral | Emotion prompt for the generation. Currently supports single-word emotions only. | |
| Model mode | lips, face, or head | face | Controls the edit region and movement scope for the model. Available options:
|
| Lipsync mode | cut_off, loop, bounce, silence, or remap | bounce | Lipsync mode when audio and video durations are out of sync. |
| Temperature | 0 to 1 | 0.5 | Controls the expresiveness of the lipsync. |
Every API field of Sync React-1 is on its tool page: open its card above.
What can you do with Sync React-1 in VS Code?
Turn recorded or generated project footage into alternative dialogue performances. An agent can prepare shots within the 15-second limit and organize the results for comparison.
Revise a dramatic line
Pair a filmed shot with a replacement recording to try a different emotional delivery. Keep each performance edit within 15 seconds.
Repair dialogue in a generated scene
Keep an AI-generated shot you like and replace the character's dialogue and facial performance.
Localize a short presenter clip
Use a separately translated recording to match a presenter's mouth movements and expression to the new delivery.
Compare ad performances
Try neutral and happy deliveries of a short spokesperson line, then review which expression fits the message.
Update a training introduction
Replace a short instructor introduction with revised speech while retaining the existing shot and framing.
Create character dialogue tests
Use a video of one clearly visible character to compare facial expressions and head motion for a short line.
Revise a welcome message
Pair an existing presenter recording with new greeting audio to make a short welcome clip with matching facial delivery.
More on Sync React-1 and VS Code
Overview
Sync React-1 in other agents
Questions about Sync React-1 in VS Code
Can VS Code use Sync React-1?
Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Sync React-1 like any built-in tool.
How much does Sync React-1 cost in VS Code?
Up to $13.00 per run at the default inputs for 60 seconds of input. 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 Sync React-1 in VS Code?
No. Spiral runs Sync React-1 on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Sync React-1 in VS Code?
About two minutes: add the hosted server, then sign in.
Does VS Code wait while Sync React-1 runs?
Sync React-1 runs in the background. VS Code starts the run, checks on it and gives you the video when it's ready.
What is Sync React-1 useful for?
Use it to change an actor's delivery after filming or generating a scene. It can revise facial expressions and head motion alongside the dialogue, giving you another performance to review without a reshoot.
How long can a Sync React-1 clip be?
The maximum is 15 seconds. For a longer scene, prepare separate shots that each fit within that limit.
Does Sync React-1 work with AI-generated video?
Yes. It supports filmed footage and AI-generated footage, so you can revise a character's delivery after choosing the shot.
What footage should I choose for Sync React-1?
Choose a shot with one clearly visible speaker and keep the face unobstructed. React-1 does not support occlusion detection for partially hidden faces.
Can Sync React-1 dub speech in another language?
Yes, Sync supports lip sync in all spoken languages. Prepare the translation and translated recording separately, then use that recording to drive the performance.
Start using Sync React-1 in VS Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into VS Code:
set up https://spiral.ai/SKILL.md


