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

Factory Droid · Video

How to Use OmniHuman in Factory Droid

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 Factory Droid

Copy an example into Factory Droid, 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.

OmniHumanFactory Droid
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 Factory Droid

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

Use Spiral's MCP server

  1. Add the server

    Droid saves it to your user config, ~/.factory/mcp.json, so it works in every project.

    droid mcp add spiral https://api.spiral.ai/mcp --type http
  2. Sign in

    Start droid, type /mcp, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

  3. Check it

    Spiral shows as connected. needs authentication means the sign-in did not finish: run /mcp again.

    droid mcp list

Use the Spiral skill

  1. Send Factory Droid 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: Factory Droid 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 Factory Droid?

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 Factory Droid

Can Factory Droid use OmniHuman?

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

How much does OmniHuman cost in Factory Droid?

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

Do I need a fal account to use OmniHuman in Factory Droid?

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 Factory Droid?

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

Does Factory Droid wait while OmniHuman runs?

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

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

Paste this into Factory Droid:

Set up Factory Droid

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