How to Use DWPose Video in Codex
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 Codex
Copy an example into Codex, 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.
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 Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- 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: Codex 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.
Settings you can ask for
DWPose Video works from your video URL. Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Draw mode | full-pose, body-pose, face-pose, hand-pose, face-hand-mask, face-mask, or hand-mask | body-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 Codex?
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.
More on DWPose Video and Codex
Overview
DWPose Video in other agents
Questions about DWPose Video in Codex
Can Codex use DWPose Video?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run DWPose Video like any built-in tool.
How much does DWPose Video cost in Codex?
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 Codex plan is separate.
Do I need a fal account to use DWPose Video in Codex?
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 Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while DWPose Video runs?
DWPose Video runs in the background. Codex 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.
Start using DWPose Video in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


