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

Hermes · Video

How to Use OmniHuman in Hermes

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 Hermes

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

Every Monday, use OmniHuman with our approved presenter portrait and the latest weekly announcement recording. Generate a review clip only when the recording is under 30 seconds.

OmniHumanHermes
Try asking
  • Each morning, use OmniHuman to animate our instructor portrait with the approved daily lesson recording. Keep each recording under 30 seconds and collect the clip for review.

  • Every Friday, use OmniHuman with our illustrated mascot and the approved weekend event recording. Check that the recording is under 30 seconds before creating the announcement.

  • Whenever a new approved character dialogue recording arrives, use OmniHuman with its matching character artwork. Generate one preview per recording, checking that each is under 30 seconds.

  • Each month, use OmniHuman with the approved singer image and a 20-second excerpt from the latest approved vocal recording. Add the performance preview to the editorial review collection.

How to set up OmniHuman in Hermes

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

Use the Spiral skill

  1. Send Hermes 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 Spiral's MCP server

  1. Add the server and sign in

    Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

    hermes mcp add spiral \
      --url https://api.spiral.ai/mcp \
      --auth oauth \
      --connect-timeout 300
  2. Check it

    In a chat that was already open, run /reload-mcp.

    hermes mcp list
    hermes mcp test spiral

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: Hermes 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 Hermes?

Produce recurring presenter updates from an approved portrait and fresh recordings. A scheduled agent can check each recording's length and collect clips for editorial 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 Hermes

Can Hermes use OmniHuman?

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

How much does OmniHuman cost in Hermes?

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 Hermes plan is separate.

Do I need a fal account to use OmniHuman in Hermes?

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 Hermes?

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

Does Hermes wait while OmniHuman runs?

OmniHuman runs in the background. Hermes 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 Hermes

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

Paste this into Hermes:

Set up Hermes

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