Skip to content

Bytedance Dreamactor V2

Integrate

Model id bytedance/dreamactor/v2
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bytedance/dreamactor/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $0.50 500 API credits your files are measured before the run Run it on this page

Get API key
ByteDance Video to Video #motion-control#dreamactor

Motion transfer from a driving video onto characters in a reference image, including animals and animation

ByteDance · Video

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required image_url
Drop a file, or

Reference image URL for animation, accepting jpeg, jpg or png files up to 4.7 MB at resolutions from 480x480 to 1920x1080. Images above that resolution are scaled down proportionally. Subjects may include real people, animated characters, pets, and others.

•required video_url
Drop a file, or

URL pointing to the driving template video, which supplies references for motion, facial expressions, and lip movements, with full face and body driving supported. Maximum duration is 30 seconds; accepted formats are mp4, mov, and webm. Resolution must range from 200x200 to 2048x1440.

Advanced trim_first_second · enable_safety_checker
POST /run/bytedance/dreamactor/v2?wait=20 quote → $0.50
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bytedance/dreamactor/v2?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Bytedance Dreamactor V2

Transfers motion, facial expressions and lip movement from a driving video to the subject of a reference image. The image can show real people, animated characters or pets (jpeg or png, up to 4.7 MB). The driving video can be mp4, mov or webm, up to 30 seconds. `trim_first_second` removes the 1-second transition at the start of the output and is on by default.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
Reference image URL for animation, accepting jpeg, jpg or png files up to 4.7 MB at resolutions from 480x480 to 1920x1080. Images above that resolution are scaled down proportionally. Subjects may include real people, animated characters, pets, and others.
video_urlrequired video
Typeurl · video
URL pointing to the driving template video, which supplies references for motion, facial expressions, and lip movements, with full face and body driving supported. Maximum duration is 30 seconds; accepted formats are mp4, mov, and webm. Resolution must range from 200x200 to 2048x1440.
trim_first_secondoptional
Typeboolean
Defaulttrue
Controls removal of the opening 1-second transition from the output video. Enable to trim that initial segment.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bytedance/dreamactor/v2",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 500,
    "usd": "0.50",
    "charged": 500,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
video
object {url, content_type, file_name, file_size}Resulting video file.

For AI agents: this page as Markdown is at https://doitong.com/developers/models/bytedance/dreamactor/v2.md. All models and guides: https://doitong.com/developers/llms.txt