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

VS Code · VideoReleased 2025-03-06

How to Use Hedra Character 3 in VS Code

Hedra Character 3 turns a portrait and recorded speech or singing into a lip-synced video. Use it for seated presenters, lessons, and character narration, with restrained movement directions.

Prompts to try with Hedra Character 3 in VS Code

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

Use Hedra Character 3 with the approved presenter portrait and 20-second release narration in this project. Make a 720p announcement with seated posture, hands resting, and a stationary camera.

Hedra Character 3VS Code
Try asking
  • Use Hedra Character 3 to animate the project's teacher portrait with its 25-second tutorial recording at 720p. Request patient delivery, small head movements, and resting hands.

  • Use Hedra Character 3 with the illustrated host image and 15-second podcast excerpt in the project. Create a 720p clip with relaxed delivery and limited body movement.

  • Use Hedra Character 3 to create separate 20-second presenter clips from the project's approved portrait and English and Spanish narration recordings. Render at 720p with the same seated performance directions.

  • Use Hedra Character 3 with the clay character portrait and 12-second vocal recording in this project. Create a 720p singing clip with gentle head movement and a stationary camera.

How to set up Hedra Character 3 in VS Code

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

Use Spiral's MCP server

  1. Add the hosted server

    Use Add to VS Code on the console's Agents & MCP page, or run:

    code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
  2. Sign in

    VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

Use the Spiral skill

  1. Send VS 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 Hedra Character 3

    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": "hedra",
        "model": "hedra-character-3",
        "input": {
          "audio": {
            "url": "<url>",
            "source": "url"
          },
          "prompt": "Generate a realistic talking avatar video with lip sync",
          "resolution": "720p",
          "start_image": {
            "url": "<url>",
            "source": "url"
          },
          "aspect_ratio": "9:16"
        }
      }'

Then paste one of the prompts above: VS Code finds Hedra Character 3 on Spiral, shows the price and runs it.

Hedra Character 3 providers and prices

Spiral runs Hedra Character 3 through Hedra. Open a card for today's price, with every fee included.

HedraVideo

Settings you can ask for

Hedra Character 3 works from your prompt. Ask VS Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Resolution540p, 720p, or 1080p720p

Output resolution.

Aspect ratio1:1, 4:3, 3:4, 16:9, 9:16, 9:21, or 21:99:16

Output aspect ratio.

Duration msa whole number up to 600000

Duration in ms. At most 600000.

Every API field of Hedra Character-3 · Talking Avatar Video is on its tool page: open its card above.

What can you do with Hedra Character 3 in VS Code?

Turn project narration and character artwork into presenter videos for lessons, release announcements, or onboarding. A coding agent can select the project assets and prepare restrained performance directions for Hedra Character 3.

Short teaching videos

Animate a teacher portrait with a recorded explanation of one concept. Use patient delivery, resting hands, and a stationary camera.

Character-led product announcements

Turn a character portrait and an approved launch recording into a seated presenter clip for a product announcement.

Animated podcast excerpts

Pair an illustrated host portrait with a short spoken excerpt to make a talking podcast clip.

Bedtime storytelling

Animate a narrator portrait with a gentle story recording. Request still framing and slow, subtle head movement.

Singing character clips

Give a claymation character portrait a short vocal performance using a recorded song excerpt.

News-style briefings

Animate an anchor portrait with a recorded bulletin, using seated posture and restrained gestures.

Localized presenter videos

Create talking presenter clips from an approved portrait and separate narration recordings in the intended languages.

Questions about Hedra Character 3 in VS Code

Can VS Code use Hedra Character 3?

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Hedra Character 3 like any built-in tool.

How much does Hedra Character 3 cost in VS Code?

$0.065 per second at 720p ($0.0325 at 540p, $0.0813 at 1080p), for the audio's length. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.

Do I need a Hedra account to use Hedra Character 3 in VS Code?

No. Spiral runs Hedra Character 3 on its own Hedra account. You sign in to Spiral once and never paste a key.

How long does it take to set up Hedra Character 3 in VS Code?

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

Does VS Code wait while Hedra Character 3 runs?

Hedra Character 3 runs in the background. VS Code starts the run, checks on it and gives you the video when it's ready.

What is Hedra Character 3 best at?

Hedra Character 3 is a good fit for seated talking heads: teachers, presenters, narrators, and podcast hosts. Its examples emphasize speech delivery with limited body movement.

How long can Hedra Character 3 videos be, and what resolutions are listed?

Hedra advertises a maximum duration of 10 minutes and lists 540p, 720p, and 1080p output. Those headline specifications do not establish that every resolution supports the full maximum duration.

Does Hedra Character 3 support languages other than English?

Hedra advertises multilingual support for talking and singing videos. Use narration recorded in the intended language.

How should I prompt movement in Hedra Character 3?

Describe the performance directly: seated posture, hands resting, small head movements, and a stationary camera. Hedra uses these directions in its own teacher example.

What can make Hedra Character 3 results look unnatural?

Hedra flags exaggerated hand gestures as a known quirk and recommends explicitly restraining movement in the prompt. It also recommends clearly pronounced speech without background noise or heavy reverb.

Get started

Start using Hedra Character 3 in VS Code

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

Paste this into VS Code:

Set up VS Code

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