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

Claude Code · Video

How to Use MMAudio V2 in Claude Code

MMAudio V2 adds synchronized sound effects and ambience to existing video, using a 44.1 kHz audio model. The authors recommend V2 and report better generalization to new footage than the earlier MMAudio checkpoint.

Prompts to try with MMAudio V2 in Claude Code

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

Use MMAudio V2 on the 8-second product handling clip in this project. Request light cardboard rustling and a soft placement sound, with no speech or music, then save a review copy beside the source.

MMAudio V2Claude Code
Try asking
  • Find the golf practice clip in the project and prepare an 8-second shot around the swing. Use MMAudio V2 for a sharp club strike and quiet outdoor ambience, then mark the contact moment for review.

  • Use MMAudio V2 to make two sound passes for the project's 8-second rain scene: gentle rain and heavier rain. Keep the footage identical and put both results in a comparison page.

  • Use MMAudio V2 on the 8-second drum clip in the assets directory. Request dry drum hits matching the visible strikes, exclude voices and background music, and prepare a playback view for checking extra or missed hits.

  • Take the project's 8-second animal clip and use MMAudio V2 for barking with light outdoor ambience. Make two attempts with different seeds and label both outputs for a timing review.

How to set up MMAudio V2 in Claude Code

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

Use Spiral's MCP server

  1. 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
  2. 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

  1. Send Claude Code 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 MMAudio V2

    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/mmaudio-v2",
        "input": {
          "video_url": "https://storage.googleapis.com/falserverless/model_tests/video_models/mmaudio_input.mp4",
          "prompt": "Indian holy music"
        }
      }'

Then paste one of the prompts above: Claude Code finds MMAudio V2 on Spiral, shows the price and runs it.

MMAudio V2 providers and prices

Spiral runs MMAudio V2 through fal. Open a card for today's price, with every fee included.

falVideo

Settings you can ask for

MMAudio V2 works from your video URL and prompt. Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Negative promptwhat to leave out, in words

The negative prompt to generate the audio for.

Seed0 to 65535

The seed for the random number generator

Number of steps4 to 5025

The number of steps to generate the audio for.

Duration1 to 308

The duration of the audio to generate.

CFG strength0 to 204.5

The strength of Classifier Free Guidance.

Mask away clipon or offoff

Whether to mask away the clip.

Every API field of MMAudio V2 · Video to Video is on its tool page: open its card above.

What can you do with MMAudio V2 in Claude Code?

Add draft Foley to video assets in a game, website, or editing project with MMAudio V2. A coding agent can prepare short shots and organize sound comparisons for review.

Foley for silent AI footage

Add ambience and action sounds to short generated shots. Review each result against visible movement before using it in an edit.

Nature footage

Try environmental sound for short outdoor shots, describing the audible setting and the main visible action.

Animal clips

Generate barking or howling for footage with visible animal activity. Check that vocalizations occur at plausible moments.

Sports impact sounds

Add a draft sound pass to a short golf or racket-sport shot, then inspect the contact point for timing errors.

Percussion footage

Try synchronized hits for a short drum performance. Listen for missed strikes and extra hits before keeping the result.

Product handling videos

Prototype Foley for short shots of objects being opened, placed, or handled. Describe the materials and desired sounds as a sound-design brief.

Sound alternatives for an edit

Generate several interpretations of the same short shot by changing the sound description. Compare ambience, prominence of effects, and synchronization.

Questions about MMAudio V2 in Claude Code

Can Claude Code use MMAudio V2?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run MMAudio V2 like any built-in tool.

How much does MMAudio V2 cost in Claude Code?

$0.0013 per second. Billed on `duration`, default 8. 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 MMAudio V2 in Claude Code?

No. Spiral runs MMAudio V2 on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up MMAudio V2 in Claude Code?

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

Does Claude Code wait while MMAudio V2 runs?

MMAudio V2 runs in the background. Claude Code starts the run, checks on it and gives you the video when it's ready.

What is MMAudio V2 useful for?

Use it to add sound effects and ambience that follow visible action in existing footage. Its recommended checkpoint generates 44.1 kHz audio.

Can MMAudio V2 generate dialogue or a musical score?

Its focus is Foley: sound effects and ambience. Human speech requests can produce unintelligible mumbles, so use a dedicated speech or music model for those tasks.

What clip length should I start with?

Start with an 8-second shot, which matches the training duration. The authors warn that large departures from that length can reduce quality.

Will a 4K source produce better sound?

Higher source resolution does not improve the generated audio. Choose footage where the action is clear, and judge the result by listening to how the sound matches it.

How should I prompt MMAudio V2?

Describe the sounds you want, such as a sharp ball strike with quiet outdoor ambience. If the result follows the text too loosely, try increasing guidance strength and compare the timing again.

Get started

Start using MMAudio V2 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 Claude Code

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