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

VS Code · Video

How to Use OmniHuman in VS Code

OmniHuman turns a character image and recorded audio into a speaking or singing video with synchronized expressions and gestures. This original OmniHuman endpoint suits short presenter clips and character performances, with audio strictly under 30 seconds.

Prompts to try with OmniHuman in VS Code

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

Use OmniHuman to animate assets/presenter.png with assets/welcome.wav for our onboarding screen. Check that the recording is under 30 seconds, then save the generated clip in the project's media folder.

OmniHumanVS Code
Try asking
  • Use OmniHuman to preview the three recorded NPC lines in assets/dialogue with assets/characters/guide.png. Check that each recording is under 30 seconds and label each output with its dialogue filename.

  • Use OmniHuman to turn assets/mascot.png and assets/release-announcement.wav into a release announcement clip. Check the audio length first and keep the result with the release media assets.

  • Use OmniHuman with assets/singer.png and the first 20 seconds of assets/vocal-demo.wav. Save the singing performance as a preview for the music scene.

  • Use OmniHuman to compare assets/voice/calm.wav and assets/voice/energetic.wav against the same presenter portrait. Confirm both recordings are under 30 seconds and create a local review page showing the two takes.

How to set up OmniHuman 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 OmniHuman

    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/bytedance/omnihuman",
        "input": {
          "image_url": "https://storage.googleapis.com/falserverless/example_inputs/omnihuman.png",
          "audio_url": "https://storage.googleapis.com/falserverless/example_inputs/omnihuman_audio.mp3"
        }
      }'

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

OmniHuman providers and prices

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

falVideo
OmniHuman
fal-ai/bytedance/omnihuman

What can you do with OmniHuman in VS Code?

Create presenter clips and character dialogue previews from assets already in your project. Have the coding agent check recording lengths and organize generated takes for review.

Product introduction

Animate a presenter image with a recorded product introduction under 30 seconds. Use the clip as the spoken opening before separately edited product footage.

One-concept lesson

Pair an instructor portrait with a short explanation of one concept. Build a longer lesson from separately reviewed clips.

Game dialogue preview

Combine character artwork with a recorded line to preview facial performance and gestures before committing to a scene.

Singing character excerpt

Animate a character image with a vocal excerpt under 30 seconds for a song teaser or performance study.

Mascot announcement

Give an illustrated mascot a short recorded announcement for an event, release, or seasonal update.

Performance comparison

Use the same portrait with two recordings of a line to compare how different deliveries affect the generated expressions and movements.

Questions about OmniHuman in VS Code

Can VS Code use OmniHuman?

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

How much does OmniHuman cost in VS Code?

Up to $10.92 per run at the default inputs for 60 seconds of input. 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 fal account to use OmniHuman in VS Code?

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

How long does it take to set up OmniHuman in VS Code?

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

Does VS Code wait while OmniHuman runs?

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

What is OmniHuman best used for?

OmniHuman suits short presenter clips and recorded character performances where speech, expressions, and gestures need to work together. Start with a character image and the finished recording.

How long can an OmniHuman clip be?

Keep the audio strictly under 30 seconds. The generated video follows the recording's duration, so divide longer material into separate takes.

Does OmniHuman animate more than a face?

Yes. OmniHuman supports close-up portraits, half-body images, and full-body images, allowing gestures to appear alongside facial animation.

Can OmniHuman make a character sing?

Yes. Singing is supported alongside speech; use a recorded vocal excerpt under 30 seconds for this endpoint.

Can OmniHuman animate illustrated characters?

Yes. The research demonstrations include cartoons, animals, and artificial objects. Try a short sample with the intended artwork before producing a series.

Get started

Start using OmniHuman 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