Bytedance Dreamactor V2
Playground
Try it on WavespeedAI!ByteDance DreamActor V2 transfers motion from a driving video to characters in an image. Great performance for non-human and multiple characters. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
ByteDance DreamActor V2
DreamActor V2 is ByteDance’s advanced motion transfer model that animates any character image using a driving video. Upload a portrait or character image and a reference video — the model makes your character perform the same movements, expressions, and gestures as the person in the driving video.
Why Choose This?
-
Motion transfer Transfer movements, expressions, and gestures from a driving video to any character image.
-
Any character Works with photos, illustrations, anime characters, or any portrait-style image.
-
Expression capture Accurately captures facial expressions, head movements, and body gestures.
-
Natural animation Generates smooth, realistic motion that matches the driving video timing.
-
Simple workflow Just two inputs — an image and a video — no complex setup required.
Parameters
| Parameter | Required | Description |
|---|---|---|
| image | Yes | Character image to animate (URL or upload) |
| video | Yes | Driving video with movements to transfer (URL or upload) |
How to Use
- Upload your character image — provide a portrait or character image to animate.
- Upload your driving video — provide a video with the movements you want to transfer.
- Run — submit and download the animated video.
Pricing
| Video Duration | Cost |
|---|---|
| 1 second | $0.05 |
| 5 seconds | $0.25 |
| 10 seconds | $0.50 |
| 30 seconds | $1.50 |
Billing Rules
- Rate: $0.05 per second of driving video
- Total cost = video duration × $0.05
Best Use Cases
- Virtual Avatars — Create animated avatars that mirror real human movements.
- Content Creation — Make characters or illustrations come to life with realistic motion.
- Digital Humans — Generate expressive digital human videos for marketing or entertainment.
- Social Media — Create engaging character animations for viral content.
- Gaming & Entertainment — Animate game characters or mascots with real motion capture.
Pro Tips
- Use a clear, front-facing character image for best results.
- The driving video should have clear, visible movements and expressions.
- Ensure good lighting in the driving video for accurate motion capture.
- Shorter driving videos are faster to process and more cost-effective for testing.
- Use videos with a single person and minimal background movement.
Notes
- Both image and video are required fields.
- Billing is based on the duration of the driving video.
- Ensure uploaded URLs are publicly accessible.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/bytedance/dreamactor-v2" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"enable_sync_mode": false,
"enable_base64_output": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| image | string | Yes | - | Reference image (JPEG/PNG). Max 4.7MB. Resolution: 480x480 to 1920x1080. | |
| video | string | Yes | - | Driving video (MP4/MOV/WebM). Max 30 seconds. Resolution: 200x200 to 2048x1440. | |
| enable_sync_mode | boolean | No | false | - | If set to true, the function will wait for the result before returning. This property is only available through the API. |
| enable_base64_output | boolean | No | false | - | If enabled, the output will be encoded into a BASE64 string. This property is only available through the API. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated video. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |