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

Cursor · AudioReleased 2026-10-20

How to Use HeyGen Voice Turbo in Cursor

Use HeyGen Voice Turbo for recurring narration and batches of spoken messages. It uses the same voices as HeyGen Voice with a shorter generation step, making it a practical choice for frequent revisions.

Prompts to try with HeyGen Voice Turbo in Cursor

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

Use the onboarding documentation to write three short welcome messages, each explaining one action. Generate each separately with HeyGen Voice Turbo and save the scripts beside the audio.

HeyGen Voice TurboCursor
Try asking
  • Take the product description from the project and draft a 60-word ad read without adding claims. Use HeyGen Voice Turbo to generate the same script with expressiveness_boost set to 0.3 and 0.8 for comparison.

  • Read this paragraph aloud with HeyGen Voice Turbo in a calm, warm voice and give me the MP3. Save the result in ./assets.

  • Make a 30-second podcast intro voiceover with HeyGen Voice Turbo.

  • Turn these release notes into a short audio briefing with HeyGen Voice Turbo.

How to set up HeyGen Voice Turbo in Cursor

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

Use Spiral's MCP server

  1. Add the hosted server

    Use Add to Cursor on the console's Agents & MCP page, or add this to .cursor/mcp.json (one project) or ~/.cursor/mcp.json (every project):

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

    Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

Use the Spiral skill

  1. Send Cursor 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 HeyGen Voice Turbo

    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": "heygen/heygen-voice/turbo",
        "input": {
          "text": "Hello! This is HeyGen Voice, speaking on fal."
        }
      }'

Then paste one of the prompts above: Cursor finds HeyGen Voice Turbo on Spiral, shows the price and runs it.

HeyGen Voice Turbo providers and prices

Spiral runs HeyGen Voice Turbo through fal. Open a card for today's price, with every fee included.

falAudio
HeyGen Voice Turbo
heygen/heygen-voice/turbo

Settings you can ask for

HeyGen Voice Turbo works from your text. Ask Cursor for any of these in your prompt.

SettingAllowed valuesDefaultDescription
VoiceJonah, Nadine, Tabitha, Soren, Elowen, Vincent, Jocelyn, Marielle and 16 moreJonah

HeyGen public voice. Ignored when reference_audio_url is set.

Languagear, be, bg, ca, cs, da, de, el and 31 more

Language of the text. Detected from the text when omitted.

Expressiveness boost0 to 11

How expressive the delivery is.

Every API field of HeyGen Voice Turbo is on its tool page: open its card above.

What can you do with HeyGen Voice Turbo in Cursor?

Turn project documentation into spoken walkthroughs, onboarding messages, and tutorial narration. Have the agent draft scripts from the files, then generate separate audio sections for review.

Course lesson narration

Turn a lesson script into spoken instruction. Test one explanatory paragraph with lower expressiveness before producing the remaining sections.

App welcome messages

Create a spoken welcome that explains the app's first useful action. Keep the script focused on one task and review the opening sentence by ear.

Support reply audio

Convert an approved troubleshooting answer into a spoken response. Use short sentences and listen for pauses between instructions.

Podcast intros

Generate an introduction from the episode title and summary. Keep production directions outside the spoken script and audition the complete introduction.

Ad read comparisons

Produce several reads of approved ad copy with different expressiveness levels. Compare delivery while keeping the wording fixed.

Product walkthrough narration

Write a spoken explanation of a product workflow, then generate each section separately. Review terminology and pacing before adding the narration to the edit.

HeyGen Voice Turbo 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
12.5s
Runs, last 24 hours
21
ToolSuccessMedian timeRuns
HeyGen Voice Turbo100.0%12.5s21

Questions about HeyGen Voice Turbo in Cursor

Can Cursor use HeyGen Voice Turbo?

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run HeyGen Voice Turbo like any built-in tool.

How much does HeyGen Voice Turbo cost in Cursor?

Each item in `text` adds $0.0000052. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.

Do I need a fal account to use HeyGen Voice Turbo in Cursor?

No. Spiral runs HeyGen Voice Turbo 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 Voice Turbo in Cursor?

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

Does Cursor wait while HeyGen Voice Turbo runs?

HeyGen Voice Turbo runs in the background. Cursor starts the run, checks on it and gives you the audio when it's ready.

How should I choose between HeyGen Voice and HeyGen Voice Turbo?

Turbo uses the same voices with a shorter generation step. Choose it when frequent revisions or repeated narration make speed useful; compare a representative passage before committing to a longer project.

What audio format does HeyGen Voice produce?

HeyGen Voice and HeyGen Voice Turbo produce 44.1 kHz WAV audio. That gives you an audio file to use in an editor or app.

How much expressiveness should I use?

Start lower for instructional narration and higher for an ad read. Zero gives the baseline delivery; compare the same sentence at different levels before generating the full script.

How should I write a script for HeyGen Voice?

Write complete sentences with enough context to establish the intended emotion. The model reads contextual cues, so test a complete paragraph rather than judging a voice from an isolated word.

Can I count on an exact emotional performance?

Text-to-speech can miss subtle tone, pacing, or emotion. Review important lines by ear and try revised wording or punctuation before approving the recording.

Get started

Start using HeyGen Voice Turbo in Cursor

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

Paste this into Cursor:

Set up Cursor

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