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

Grok · Video

How to Use DWPose Video in Grok

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 Grok

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

Use DWPose Video on this dance rehearsal. Show body poses so I can review the choreography.

DWPose VideoGrok
Try asking
  • Use DWPose Video on this hand gesture demonstration. Show hand poses for animation reference.

  • Use DWPose Video on this performance take. Show facial landmarks so I can review the face movement.

  • Use DWPose Video on this exercise demonstration. Show body poses and return the result for my coach to review.

  • Use DWPose Video on this character movement reference. Include body, hand, and face poses together for my animation review.

How to set up DWPose Video in Grok

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

Use the Grok connector

  1. Add a custom connector

    In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.

    https://api.spiral.ai/mcp
  2. Sign in to Spiral and approve

    Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.

  3. Check that it is connected

    Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.

Use the Spiral skill

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

Make movement easier to inspect by turning a supplied video into a pose visualization. Ask for the pose details that match your task, then review the result beside the original.

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 Grok

Can Grok use DWPose Video?

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

How much does DWPose Video cost in Grok?

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

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

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

About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.

Does Grok wait while DWPose Video runs?

DWPose Video runs in the background. Grok 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 Grok

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

Paste this into Grok:

Set up Grok

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