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

Windsurf · Video

How to Use DWPose Video in Windsurf

DWPose Video turns existing footage into pose visualization videos for movement review and animation reference. It works across a moving sequence, with body, hand, and facial pose views for different tasks.

Prompts to try with DWPose Video in Windsurf

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

Use DWPose Video on the rehearsal clip in this project with a body pose view. Add the result to our existing video review page beside the original.

DWPose VideoWindsurf
Try asking
  • Process the gesture demo in this project's media folder with DWPose Video using a hand pose view. Save the result with a matching source name for the animation team.

  • Use DWPose Video to create a facial pose view of the performance clip in this project. Add it to the existing take review player.

  • Run DWPose Video on the project's character reference footage with body, hand, and face poses together. Prepare the output for manual review before our animation stage.

  • Use DWPose Video on the project's movement reference clip. Extract frames from the resulting pose video for our existing ControlNet reference browser.

How to set up DWPose Video in Windsurf

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

Use Spiral's MCP server

  1. Add the server

    Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:

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

    Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

    devin mcp login spiral
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf 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 DWPose Video

    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/dwpose/video",
        "input": {
          "video_url": "https://storage.googleapis.com/falserverless/gallery/Ben2/100063-video-2160.mp4"
        }
      }'

Then paste one of the prompts above: Windsurf finds DWPose Video on Spiral, shows the price and runs it.

DWPose Video providers and prices

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

falVideo

Settings you can ask for

DWPose Video works from your video URL. Ask Windsurf for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Draw modefull-pose, body-pose, face-pose, hand-pose, face-hand-mask, face-mask, or hand-maskbody-pose

Mode of drawing the pose on the video. Options are: 'full-pose', 'body-pose', 'face-pose', 'hand-pose', 'face-hand-mask', 'face-mask', 'hand-mask'.

Every API field of DWPose Pose Prediction · Video to Pose is on its tool page: open its card above.

What can you do with DWPose Video in Windsurf?

Turn project footage into pose references for a movement review tool or animation workflow. A coding agent can organize the results and build a player that shows the original and pose video together.

Choreography reference

Extract body pose visuals from a dance rehearsal for a choreographer to review alongside the original footage.

Exercise movement review

Create a body pose view of an exercise demonstration for a coach to inspect.

Hand gesture reference

Extract hand pose visuals from a gesture demonstration for an animator to use as reference.

Facial movement reference

Create a facial landmark video from a performance take for visual review.

Character animation preparation

Prepare pose reference footage for a separate character animation workflow, reviewing the extraction before reuse.

Pose-guided image preparation

Extract a pose video, then select frames as references for a compatible ControlNet workflow.

Questions about DWPose Video in Windsurf

Can Windsurf use DWPose Video?

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

How much does DWPose Video cost in Windsurf?

Up to $0.0468 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 Windsurf plan is separate.

Do I need a fal account to use DWPose Video in Windsurf?

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

How long does it take to set up DWPose Video in Windsurf?

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

Does Windsurf wait while DWPose Video runs?

DWPose Video runs in the background. Windsurf starts the run, checks on it and gives you the video when it's ready.

What does DWPose Video produce?

It produces a pose visualization video from existing footage. Use the result to review movement or prepare a visual pose reference.

Can DWPose detect hands and faces?

Yes. DWPose estimates hand and facial landmarks alongside body keypoints, though the authors flag small hands and faces as challenging.

How should I choose which pose details to show?

Match the view to the task: body movement for choreography, hands for gesture reference, and facial landmarks for face movement. Include body, hands, and face together when you need their relationship.

Where should I check DWPose results most carefully?

Review moments when people overlap, body parts are hidden, or fingers form complex poses. The authors identify these as difficult cases for whole-body pose estimation.

Can DWPose poses guide image generation or character animation?

Yes. The official project documents ControlNet use and support for Animate Anyone character animation. Treat the pose video as a reference for a separate generation workflow.

Get started

Start using DWPose Video in Windsurf

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

Paste this into Windsurf:

Set up Windsurf

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