POST
/
api
/
v1
/
client
/
videos
/
replace
Video Replace (Animate)
curl --request POST \
  --url http://localhost:8000/api/v1/client/videos/replace \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form video='@example-file' \
  --form ref_image='@example-file' \
  --form model=Wan2_2_Animate \
  --form 'prompt=<string>' \
  --form width=123 \
  --form height=123 \
  --form steps=4 \
  --form seed=-1 \
  --form 'webhook_url=<string>'
{
  "data": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Authorizations

Authorization
string
header
required

API key obtained from the ModelBeam dashboard

Body

multipart/form-data
video
file
required

Input video file (MP4, MPEG, QuickTime, AVI, WMV, OGG)

ref_image
file
required

Reference character image (JPG, JPEG, PNG, GIF, BMP, WebP; max 10MB)

model
string
required
Example:

"Wan2_2_Animate"

prompt
string

Text prompt to guide the replacement

width
integer

Output video width (must be provided with height)

height
integer

Output video height (must be provided with width)

steps
integer
default:4

Inference steps

seed
integer
default:-1

Random seed

webhook_url
string
Maximum string length: 2048

Response

Video replace job created

data
object