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

Windsurf · AudioReleased 2025-04-07

How to Use ElevenLabs Forced Alignment in Windsurf

ElevenLabs Forced Alignment matches an existing transcript to recorded audio, returning word and character timestamps for captions and read-along text. Use it when you already have the words and need their timing.

Prompts to try with ElevenLabs Forced Alignment in Windsurf

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

Use ElevenLabs Forced Alignment to align narration.mp3 with transcript.txt in this project, then generate a WebVTT caption file without rewriting the transcript.

ElevenLabs Forced AlignmentWindsurf
Try asking
  • Use ElevenLabs Forced Alignment on the project's lesson recording and transcript, then add word highlighting to the existing audio player.

  • Use ElevenLabs Forced Alignment with the interview audio and approved transcript in this repository, then add click-to-seek behavior to the transcript view.

  • Use ElevenLabs Forced Alignment on the tutorial recording and transcript, then create a review table containing each sentence and its first and last word timestamps.

  • Use ElevenLabs Forced Alignment on the project's narration and transcript, then build a review view that displays word-level loss scores alongside playback controls.

How to set up ElevenLabs Forced Alignment 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 ElevenLabs Forced Alignment

    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/elevenlabs/forced-alignment",
        "input": {
          "audio_url": "https://storage.googleapis.com/falserverless/example_inputs/elevenlabs/scribe_v2_in.mp3",
          "text": "Hey, this is a test recording for Scribe version two, which is now available on fal.ai."
        }
      }'

Then paste one of the prompts above: Windsurf finds ElevenLabs Forced Alignment on Spiral, shows the price and runs it.

ElevenLabs Forced Alignment providers and prices

Spiral runs ElevenLabs Forced Alignment through fal. Open a card for today's price, with every fee included.

falAudio
Elevenlabs - Forced Alignment
fal-ai/elevenlabs/forced-alignment

What can you do with ElevenLabs Forced Alignment in Windsurf?

Build caption tools, read-along players, and transcript navigation from word and character timestamps. A coding agent can connect the alignment results to your project's player and editing code.

Time captions for recorded videos

Align a finished transcript with the recording, then have your agent turn the word timings into subtitle cues for review.

Build read-along lessons

Use word timestamps to highlight lesson text as the narration plays. Review the timing around pauses before publishing.

Navigate recordings through text

Align a transcript so a player can jump from a selected word or search result to the corresponding passage in the audio.

Find interview quotes for editing

Match an approved interview transcript to its recording, then use the timestamps to prepare a list of candidate clip boundaries.

Cue narrated presentations

Align a presentation transcript with its narration, then ask your agent to map selected phrases to slide-change cues.

Synchronize tutorial callouts

Time an existing tutorial transcript, then use selected word boundaries to place labels or explanatory callouts in a video editor.

Questions about ElevenLabs Forced Alignment in Windsurf

Can Windsurf use ElevenLabs Forced Alignment?

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run ElevenLabs Forced Alignment like any built-in tool.

How much does ElevenLabs Forced Alignment cost in Windsurf?

Up to $0.286 per run at the default inputs. 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 ElevenLabs Forced Alignment in Windsurf?

No. Spiral runs ElevenLabs Forced Alignment on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up ElevenLabs Forced Alignment in Windsurf?

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

Does Windsurf wait while ElevenLabs Forced Alignment runs?

ElevenLabs Forced Alignment runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

Does ElevenLabs Forced Alignment transcribe audio?

It times a transcript you already have against the recording. If you do not have a transcript, transcribe the audio first.

What timing detail does ElevenLabs Forced Alignment return?

It returns timestamps for individual words and characters. Your agent can use those timings to prepare captions, read-along highlighting, or navigation within a recording.

How long can a recording be?

The served endpoint documents recordings up to 10 hours and files up to 3 GB. ElevenLabs also documents a transcript limit of 675,000 characters.

Can ElevenLabs Forced Alignment identify speakers?

Speaker diarization is not supported. Keep speaker identification as a separate task.

How many languages does ElevenLabs Forced Alignment support?

The Forced Alignment overview lists 29 supported languages. Check that list before planning an alignment workflow for a particular language.

Get started

Start using ElevenLabs Forced Alignment 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