How to Use Sync React-1 in Gemini
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 Gemini
Copy an example into Gemini, or ask in your own words.
Use Sync React-1 with this 10-second presenter video and replacement recording. Give the presenter a happy expression while retaining the existing head movement.
Use Sync React-1 to revise this 8-second dramatic shot with the supplied dialogue recording. Make the expression sad and allow head movement to follow the delivery.
Use Sync React-1 to dub this 12-second welcome video with the supplied Spanish recording. Keep the expression neutral and retain the existing head movement.
Use Sync React-1 to try two deliveries of this 9-second ad using the same video and recording: one neutral and one happy. Change facial expressions without adding head movement.
Use Sync React-1 to replace the dialogue in this 10-second AI-generated character video with the supplied recording. Use a surprised expression and include head movement.
How to set up Sync React-1 in Gemini
Pick the way that suits you. Each takes about two minutes.
Use the Gemini connector
- Open Connected Apps
On your computer, go to gemini.google.com. At the bottom, click Settings › Connected Apps. If you don't see Connected Apps, click Personal Intelligence first, then Connected Apps.
- Add Spiral as a custom app
Under Custom apps, click Add a custom app and paste this MCP server URL:
https://api.spiral.ai/mcp
- Sign in to Spiral and approve
Follow the on-screen instructions. Spiral opens: sign in, pick the organization and click Authorize. No API key.
Use the Spiral skill
- Send Gemini 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: Gemini 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 Gemini 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 Gemini?
Try a different emotional delivery while keeping a filmed or generated shot. Bring a short video and replacement recording, then ask for facial expression changes or head movement to suit the scene.
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 Gemini
Overview
Sync React-1 in other agents
Questions about Sync React-1 in Gemini
Can Gemini use Sync React-1?
Yes. Add Spiral to Gemini as an MCP server, and Gemini can find and run Sync React-1 like any built-in tool.
How much does Sync React-1 cost in Gemini?
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 Gemini plan is separate.
Do I need a fal account to use Sync React-1 in Gemini?
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 Gemini?
About two minutes: open Connected Apps, then add Spiral as a custom app, then sign in to Spiral and approve.
Does Gemini wait while Sync React-1 runs?
Sync React-1 runs in the background. Gemini 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 Gemini
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini:
set up https://spiral.ai/SKILL.md


