Steady Dancer | AI Motion Control Video API

wavespeed-ai/steady-dancer — Image-to-Video Motion Transfer

Steady Dancer is WaveSpeedAI’s motion-transfer model: you upload a character image and a driving video, and it generates a new clip where your character follows the motion from the video while keeping a stable face, outfit, and overall identity. Ideal for dance edits, cosplay previews, and social short-form content.

What is SteadyDancer?

SteadyDancer is a 14-billion parameter human image animation framework that converts static images into coherent dance motion videos. Built on diffusion models, it uses an Image-to-Video paradigm with key innovations for high-quality animation.

✨ Highlights

Image-driven identity – Uses your uploaded image as the main reference for face, outfit, and body shape.
Video-driven motion – Copies camera movement and body motion from the driving video.
Stability-focused – Designed to keep faces, limbs, and outfit details consistent across frames.
Resolution choices – Output at 480p for quick previews or 720p for higher-quality clips.
Prompt-guided style (optional) – Add a short text prompt to nudge colour, atmosphere, or style, or leave blank for neutral transfer.

🧩 Parameters

image* – Required. The character / subject image to insert into the motion.
video* – Required. Driving video whose motion and camera you want to reuse.
prompt – Optional text description for style / mood (e.g. “cinematic lighting, soft film grain, vivid colours”).
resolution – Output resolution: 480p or 720p.
seed – -1 for random; any other integer for reproducible results.

💰 Pricing

Pricing is based on video length, resolution, and billed in 5-second blocks, with:

Minimum billable length: 5 seconds
Maximum billable length: 120 seconds (anything longer is charged as 120 s)
Base price: $0.2 per 5 seconds at 480p

Effective rates:

Resolution	Effective price per second	5 s clip	10 s clip	60 s clip	120 s clip (cap)
480p	≈ $0.04 / s	$0.20	$0.40	$2.40	$4.80
720p	≈ $0.08 / s (×2)	$0.40	$0.80	$4.80	$9.60

Internally, the system:

Takes your video duration (capped at 120 s),
Rounds it into 5-second blocks,
Multiplies by the base price, and
Applies a ×2 multiplier for 720p.

🚀 How to Use

Upload image – choose the face / character you want to animate.
Upload video – select the motion source clip.
(Optional) Enter a prompt to guide overall look and mood.
Choose resolution (start with 480p for fast tests; switch to 720p for final export).
(Optional) Set a fixed seed if you want to reproduce or slightly tweak the same take later.
Click Run and download the generated video once completed.

🎯 Recommended Use Cases

Dance and performance remixes using a static character or avatar.
Cosplay or outfit previews based on a single photo.
VTuber / virtual idol short clips for social platforms.
Quick pre-viz for ad concepts or character motion tests.

💡 Tips & Notes

For best results, keep framing similar between the image and driving video (e.g. both full-body or both mid-shot).
Avoid extremely fast motion, strong occlusions, or very busy backgrounds in the driving video for first tests.
If faces look unstable, try a clearer input image or reduce extreme camera shake in the driving clip.

Reference

Read the details from official page.

Try other models and see the difference

fun-control — A playful motion-remix model built on ’s Wan 2.2, for controllable character and camera movement from simple prompts.
wan-animate — A general animation model powered by ’s Wan 2.2, turning text or images into smooth, high-quality short videos.

Steady Dancer API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/steady-dancer with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Steady Dancer below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/steady-dancer" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "image": "https://example.com/your-input.jpg",
    "video": "https://example.com/your-input.mp4",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "resolution": "480p",
    "seed": -1
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("wavespeed-ai/steady-dancer", {
        "image": "https://example.com/your-input.jpg",
        "video": "https://example.com/your-input.mp4",
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "resolution": "480p",
        "seed": -1
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "wavespeed-ai/steady-dancer",
    {
    "image": "https://example.com/your-input.jpg",
    "video": "https://example.com/your-input.mp4",
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "resolution": "480p",
    "seed": -1
}
)

print(output["outputs"][0])  # → URL of the generated output

Steady Dancer API — Frequently asked questions

What is the Steady Dancer API?

Steady Dancer is a WaveSpeedAI model for pose / motion driven video, exposed as a REST API on WaveSpeedAI. SteadyDancer is a 14B-parameter human image animation framework that transforms static images into coherent dance videos. Features first-frame preservation, robust identity consistency, and temporal coherence for realistic motion generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Steady Dancer API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/steady-dancer.

How much does Steady Dancer cost per run?

Steady Dancer starts at $0.20 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Steady Dancer accept?

Key inputs: `prompt`, `image`, `video`, `resolution`, `seed`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/wavespeed-ai/steady-dancer.

How long does Steady Dancer take to generate?

Average end-to-end generation time on WaveSpeedAI is around 160 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Steady Dancer outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

ExamplesView all

Related Models

README