Transfer Motion

Transfer motion from a reference video onto a static image, animating it with the same movement.

Endpoint

POST
/api/v1/jobs

Create a transfer_motion job

Credits

Cost

200 credits per job.

Input Parameters

Request Body

NameTypeDescription
workflowrequiredstring"transfer_motion"
input.imageUrlrequiredstringURL of the static image to animate
input.motionVideoUrlrequiredstringURL of the reference motion video
webhookUrlstringURL to receive completion notification

Example Request

Create Transfer Motion Job

curl -X POST https://vydra.ai/api/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "transfer_motion",
    "input": {
      "imageUrl": "https://example.com/character.png",
      "motionVideoUrl": "https://example.com/dance.mp4"
    }
  }'

Example Response

Response (201 Created)json
{
  "id": "990e8400-e29b-41d4-a716-446655440004",
  "status": "running",
  "workflow": "transfer_motion",
  "creditsCharged": 200,
  "createdAt": "2026-01-26T12:00:00.000Z",
  "_links": {
    "self": "https://vydra.ai/api/v1/jobs/990e8400-e29b-41d4-a716-446655440004",
    "status": "https://vydra.ai/api/v1/jobs/990e8400-e29b-41d4-a716-446655440004"
  }
}

Best Results

For best results, use a motion video with a single subject and clear movement. The static image should have a similar pose or composition to the first frame of the video.