How to Use HeyGen Lipsync Precision in Claude Code
HeyGen Lipsync Precision matches a speaker’s mouth movements to replacement audio for dubbed videos and corrected dialogue. Compared with HeyGen Lipsync Speed, it favors mouth accuracy for final cuts, including footage with side angles.
Prompts to try with HeyGen Lipsync Precision in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use HeyGen Lipsync Precision to match assets/demo.mp4 to assets/demo-es.wav. Check the recording lengths first and allow duration adjustment for the Spanish dub.
Use HeyGen Lipsync Precision to correct seconds 12 through 18 of assets/onboarding.mp4 with the approved replacement recording in assets/correction.wav. Prepare that section for review.
Use HeyGen Lipsync Precision on the 15-second presenter excerpt in assets/angle-test.mp4 with assets/angle-test.wav. Make this the review sample before processing the full demo.
Use HeyGen Lipsync Precision to create French and German editions of assets/tutorial.mp4 using the matching approved recordings in assets/dubs/. Keep each result labeled by language.
Use HeyGen Lipsync Precision to revoice assets/training.mp4 with assets/training-updated.wav. Remove the source background music and enable speech enhancement for this review render.
How to set up HeyGen Lipsync Precision in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude 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 HeyGen Lipsync Precision
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/heygen/v3/lipsync/precision", "input": { "video_url": "https://v3b.fal.media/files/b/0a9004c7/FM7Q5tK2b59x66Bl8HC0Z_vt-lang-en.mp4", "audio_url": "https://v3b.fal.media/files/b/example/new_audio.mp3" } }'
Then paste one of the prompts above: Claude Code finds HeyGen Lipsync Precision on Spiral, shows the price and runs it.
HeyGen Lipsync Precision providers and prices
Spiral runs HeyGen Lipsync Precision through fal. Open a card for today's price, with every fee included.
Settings you can ask for
HeyGen Lipsync Precision works from your video URL and audio URL. Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Enable caption | on or off | off | Generate captions in the output video. |
| Enable dynamic duration | on or off | on | Allow duration adjustment to match the new audio. |
| Disable music track | on or off | off | Remove background music from the source video. |
| Enable speech enhancement | on or off | off | Enhance the replacement audio quality. |
| Start time | a number from 0 | Start time in seconds for partial lipsync. | |
| End time | a number from 0 | End time in seconds for partial lipsync. |
Every API field of HeyGen Lipsync (Precision) is on its tool page: open its card above.
What can you do with HeyGen Lipsync Precision in Claude Code?
Turn project demo footage into localized presenter videos or correct spoken mistakes before release. A coding agent can pair project video and audio assets, then prepare short excerpts for review.
Localized product demonstrations
Match an existing presenter video to a separately recorded Spanish or Japanese product explanation.
Corrected dialogue
Replace a misspoken line with a corrected recording and target the affected section for lip sync.
Updated employee training
Revoice a presenter’s explanation when a policy or procedure changes.
Regional campaign dubs
Create localized editions of a filmed ad using approved voice recordings for each market.
Course localization
Match an instructor’s visible speech to translated lesson audio prepared by a separate translation workflow.
Dialogue replacement for final edits
Apply replacement dialogue to filmed scenes where accurate mouth movement matters, testing difficult angles first.
More on HeyGen Lipsync Precision and Claude Code
Overview
HeyGen Lipsync Precision in other agents
Questions about HeyGen Lipsync Precision in Claude Code
Can Claude Code use HeyGen Lipsync Precision?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run HeyGen Lipsync Precision like any built-in tool.
How much does HeyGen Lipsync Precision cost in Claude Code?
Up to $11.70 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 Claude Code plan is separate.
Do I need a fal account to use HeyGen Lipsync Precision in Claude Code?
No. Spiral runs HeyGen Lipsync Precision on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up HeyGen Lipsync Precision in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while HeyGen Lipsync Precision runs?
HeyGen Lipsync Precision runs in the background. Claude Code starts the run, checks on it and gives you the video when it's ready.
What does HeyGen Lipsync Precision change?
It reanimates the speaker’s mouth to match replacement speech on an existing video and returns a synced MP4. Prepare the replacement recording before requesting the lip sync.
When should I choose Precision over Speed?
Choose HeyGen Lipsync Precision for final cuts where mouth accuracy matters, especially with side angles or facial movement. HeyGen Lipsync Speed is aimed at rapid drafts.
Does HeyGen Lipsync Precision translate speech?
Lipsync matches footage to audio you supply. For a translated dub, prepare the translated recording first; HeyGen’s Video Translation service handles translation separately.
Which languages can the replacement recording use?
HeyGen says uploaded audio can use any language, dialect, or accent because lip sync follows speech sounds. Check pronunciation and wording in the recording before rendering.
What footage should I test before processing a full video?
Test an excerpt with the hardest camera angle, lighting, or mouth obstruction. Those conditions affect results even when using Precision.
Start using HeyGen Lipsync Precision in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


