AI Dance Replace API for Motion-Driven Video

Access ai_dance_replace through the GoEnhance API to replace the person in a reference dance video with the person from one source image while retaining the reference motion. Submit an asynchronous task, save its img_uuid, then poll or use callbacks for completion.
Get API Key
Dancer performing in a cinematic production studio for AI Dance Replace API workflows

Build person-replacement dance video workflows

Define the replacement person

Provide a public image_url. The person in that image becomes the subject used in the generated dance video, so validate the URL before submission.
Portrait capture setup for a person image used by a dance replacement API

Drive motion from a dance video

Provide a public video_url containing the reference dance. The documented limit is 30 seconds; longer videos are rejected.
Dancer and cinema camera capturing motion for an AI dance replacement workflow
Validate the exact model identifier, media URLs, and output resolution before submission.

AI Dance Replace API capabilities and inputs

Exact model identifier

Set model to ai_dance_replace; it is a required request field.

Required person image

Pass image_url as a valid public URI for the person who will appear in the output.

Required dance video

Pass video_url as a public reference video no longer than the documented 30-second maximum.

Two resolution options

Choose 480p or 720p. The documented default is 480p.

Optional callback delivery

Add a public HTTPS custom_callback_url to receive processing, success, and failure updates.

Asynchronous task response

A successful submission returns img_uuid; persist it for status checks and result handling.
Billing uses the rounded-up duration of the input video. Calculate cost from the selected resolution and billed seconds.

AI Dance Replace API pricing

480p pricing

2 tokens per input-video second, equal to $0.04 per second or $0.20 per 5 seconds at $0.02 per token.

720p pricing

4 tokens per input-video second, equal to $0.08 per second or $0.40 per 5 seconds at $0.02 per token.

Duration-based billing

The input video duration is rounded up for billing; estimate cost as billed seconds multiplied by the selected rate.

Integrate the GoEnhance API in six steps

1

1. Create an API key

Create a GoEnhance API key and send it as a bearer token in the Authorization header.
2

2. Validate both media URLs

Confirm the person image and dance video are publicly reachable and that the video is no longer than 30 seconds.
3

3. Build the request

Set model: ai_dance_replace, add image_url and video_url, then choose 480p or 720p.
4

4. Submit the task

POST the JSON body to https://api.goenhance.ai/api/v1/videos/generations.
5

5. Persist and track

Save the returned img_uuid, then poll GET /api/v1/jobs/detail or receive callback events.
6

6. Handle terminal states

Process success and failure idempotently, verify the returned asset, and avoid duplicating downstream work.
Get API Key
Use a consent-aware media pipeline for creator tools, campaign production, and repeatable video automation.

Developer use cases for dance replacement video

Creator dance templates

Let users apply an approved person image to a licensed reference dance inside a guided creation flow.

Campaign video variants

Generate subject variants from approved source media for internal review and downstream editing.

Character performance tests

Explore how a supplied character image follows an existing movement reference before production.

Localized creator assets

Reuse one approved dance reference with different authorized subjects for regional content pipelines.

Automated content queues

Connect task IDs and callbacks to batch orchestration without blocking your application request thread.

Prototype motion experiences

Validate an image-plus-motion product concept before investing in a custom capture pipeline.
Answers to common input, pricing, status, callback, and integration questions.

AI Dance Replace API FAQ

What endpoint does the AI Dance Replace API use?

Send POST https://api.goenhance.ai/api/v1/videos/generations with model: ai_dance_replace, a public image_url, and a public video_url.

How does AI Dance Replace API pricing work?

Pricing is based on the rounded-up input-video duration: 2 tokens per second at 480p and 4 tokens per second at 720p, equal to $0.20 and $0.40 per 5 seconds respectively.

Which fields are required?

The documented required fields are model, image_url, and video_url. Resolution and callback URL are optional.

How long can the reference dance video be?

The documented maximum is 30 seconds. Validate duration before submission because longer videos are rejected.

Which output resolutions are available?

The endpoint accepts 480p and 720p. If omitted, the documented default is 480p.

How do I check task status?

Persist the returned img_uuid and poll GET /api/v1/jobs/detail, or provide a public HTTPS callback URL.

How are callback failures handled?

GoEnhance documents up to three retries when your callback endpoint does not return HTTP 200, with a three-second timeout for each attempt.

What permissions should my app require?

Use only images and dance videos you are authorized to process, and obtain appropriate consent from identifiable people in source media.

Build with the AI Dance Replace API