[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Sync React-1](https://spiral.ai/integrations/gemini-cli/sync-react-1)

# How to Use Sync React-1 in Gemini CLI

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.

|  |  |
| --- | --- |
| Model | Sync React-1 |
| Available through | fal |
| Category | Video |
| Price | Up to $13.00 per run at the default inputs for 60 seconds of input. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Sync React-1 in Gemini CLI

- 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 Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 Sync React-1**: 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": "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 CLI finds Sync React-1 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Sync React-1 tools and prices

- [Sync React-1](https://spiral.ai/tools/fal/fal-ai/sync-lipsync/react-1) (fal): $13.00 per minute.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| model_mode | lips, face, head | face | Controls the edit region and movement scope for the model. Available options: - `lips`: Only lipsync using react-1 (minimal facial changes). - `face`: Lipsync + facial expressions without head movements. - `head`: Lipsync + facial expressions + natural talking head movements. |
| lipsync_mode | cut_off, loop, bounce, silence, 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. |

## What can you do with Sync React-1 in Gemini CLI?

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.

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Sync React-1 in other agents

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

## More Gemini CLI guides

- [Sync Lipsync 2.0 Pro](https://spiral.ai/integrations/gemini-cli/sync-lipsync-2-0-pro)
- [Sync-3 Avatar](https://spiral.ai/integrations/gemini-cli/sync-3-avatar)
- [Sync Lipsync 2.0](https://spiral.ai/integrations/gemini-cli/sync-lipsync-2-0)
- [Sync-3 Lipsync](https://spiral.ai/integrations/gemini-cli/sync-3-lipsync)
- [Sync Lipsync 1.9](https://spiral.ai/integrations/gemini-cli/sync-lipsync-1-9)
- [VEED Avatars Audio to Video](https://spiral.ai/integrations/gemini-cli/veed-avatars-audio-to-video)

## Questions about Sync React-1 in Gemini CLI

**Can Gemini CLI use Sync React-1?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Sync React-1 like any built-in tool.

**How much does Sync React-1 cost in Gemini CLI?**

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 CLI plan is separate.

**Do I need a fal account to use Sync React-1 in Gemini CLI?**

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 CLI?**

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

**Does Gemini CLI wait while Sync React-1 runs?**

Sync React-1 runs in the background. Gemini CLI 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.

