Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · VideoReleased 2026-09-17

How to Use H3 Max Lip Sync in Windsurf

H3 Max Lip Sync turns a portrait and recorded audio into a talking video with synchronized mouth movements. Use it for presenter clips, recorded lessons, and greetings when you already have the spoken words.

Prompts to try with H3 Max Lip Sync in Windsurf

Copy an example into Windsurf, or ask in your own words.

Use H3 Max Lip Sync with assets/presenter.png and audio/welcome.wav to make a 1080p onboarding clip. Check that the recording lasts at least five seconds and enable transcription guidance for the spoken introduction.

H3 Max Lip SyncWindsurf
Try asking
  • Use H3 Max Lip Sync to animate portraits in assets/characters with their matching recordings in audio/dialogue. Check image ratios against 0.4 to 2.5, flag recordings shorter than five seconds, and save 768p previews.

  • Use H3 Max Lip Sync with assets/tutor.png and audio/fractions.wav to produce a 1080p lesson introduction. Check that the tutor's mouth is visible and use transcription guidance.

  • Use H3 Max Lip Sync with assets/singer.png and audio/chorus.wav to make a 10-second, 1080p singing preview. Disable transcription guidance.

  • Use H3 Max Lip Sync to make separate 1080p support clips from assets/support-host.png and the recordings in audio/help. Measure each recording first and report any image or audio that falls outside the documented limits.

How to set up H3 Max Lip Sync in Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

    {
      "mcpServers": {
        "spiral": {
          "url": "https://api.spiral.ai/mcp"
        }
      }
    }
  2. Sign in

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run H3 Max Lip Sync

    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": "minimax/h3-max/lip-sync/image-to-video",
        "input": {
          "image_url": "<image_url>",
          "audio_url": "<audio_url>"
        }
      }'

Then paste one of the prompts above: Windsurf finds H3 Max Lip Sync on Spiral, shows the price and runs it.

H3 Max Lip Sync providers and prices

Spiral runs H3 Max Lip Sync through fal. Open a card for today's price, with every fee included.

falVideo
H3 Max Lip Sync Image to Video
minimax/h3-max/lip-sync/image-to-video

Settings you can ask for

H3 Max Lip Sync works from your image URL and audio URL. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Resolution480P, 768P, 1080P, or 2K768P

Output resolution. Uses the supported aspect ratio nearest the image.

Enable transcriptionon or offoff

Transcribe the supplied audio to guide lip synchronization. When disabled, synchronize to the audio without a transcript.

Seed0 to 2147483647

Random seed; selected randomly if omitted.

Every API field of H3 Max Lip Sync Image to Video is on its tool page: open its card above.

What can you do with H3 Max Lip Sync in Windsurf?

Turn project portraits and recorded dialogue into talking assets for onboarding, support, or game previews. A coding agent can check image proportions and audio length before generating clips with H3 Max Lip Sync.

Product presenters

Pair a presenter portrait with a recorded product explanation to make a talking introduction.

Customer welcome clips

Reuse one host portrait with separate recorded greetings for new customers.

Illustrated lesson hosts

Animate a drawn tutor to recorded explanations for vocabulary, math, or study reminders.

Museum portrait narration

Give a painted portrait a recorded narration for an exhibit or classroom presentation.

Support answer videos

Turn a brand avatar and a recorded answer into a talking clip explaining one common support issue.

Singing character previews

Pair a character portrait with a sung passage and disable transcription guidance for the performance.

Recorded announcement updates

Keep a spokesperson portrait and replace the recording when an event announcement or product message changes.

Game dialogue previews

Animate character portraits to recorded dialogue to review how spoken lines look before further production.

H3 Max Lip Sync success rate and speed on Spiral

Success and speed over the last 24 hours, across every run of these tools on Spiral.

Success rate
100.0%
Fastest median run time
27.1s
Runs, last 24 hours
34
ToolSuccessMedian timeRuns
H3 Max Lip Sync Image to Video100.0%27.1s34

Questions about H3 Max Lip Sync in Windsurf

Can Windsurf use H3 Max Lip Sync?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run H3 Max Lip Sync like any built-in tool.

How much does H3 Max Lip Sync cost in Windsurf?

Up to $7.488 per run at the default inputs for 60 seconds of input. `resolution`: 480P $4.68, 768P (default) $7.488, 1080P $14.976, 2K $29.952. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

Do I need a fal account to use H3 Max Lip Sync in Windsurf?

No. Spiral runs H3 Max Lip Sync on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up H3 Max Lip Sync in Windsurf?

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

Does Windsurf wait while H3 Max Lip Sync runs?

H3 Max Lip Sync runs in the background. Windsurf starts the run, checks on it and gives you the video when it's ready.

Does H3 Max Lip Sync create the voice?

It uses the audio you supply and animates the portrait to that recording. Prepare the spoken performance before generating the video.

How long can an H3 Max Lip Sync video be?

Audio must be at least five seconds long. Current API documentation supports up to 15 minutes and says the video matches the supplied audio duration.

Can H3 Max Lip Sync animate an illustrated character?

Yes. It supports photographs, 3D renders, 2D illustrations, and paintings, so a recorded line can drive a drawn presenter or painted portrait.

What portrait works best?

Choose a clear face viewed from the front or a three-quarter angle, with the mouth visible. An obscured mouth is a poor starting point for judging lip synchronization.

Should I use transcription guidance for singing?

Turn it off for music or singing. For spoken dialogue, transcription guidance uses the recorded words to help shape mouth movements.

Get started

Start using H3 Max Lip Sync in Windsurf

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Windsurf:

Set up Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options