animate-motion-transfer API

Animate Motion Transfer transfers movement from one reference video to a single character image and produces a video. It is not text-to-video and needs no prompt.

Try online · Get an API key · Read the docs

Capabilities

Model
Video
API model
animate-motion-transfer
Endpoints
POST /v1/videos, GET /v1/videos/{id}
Parameters
images[1], metadata.video_url[1], metadata.resolution: 480p / 720p / 1080p, metadata.pose_method: vitpose / sdpose / wuwupose, metadata.max_frames, metadata.frame_rate

Current pricing

¥0.20–0.40 per second

Gallery examples

No published examples for this model yet.

Explore the prompt gallery

Quick start

Example workflow: prepare a full-body character image and a clear motion clip, then replace the example URLs with public assets you have permission to use. Exactly one image and one video are required; audio is not accepted. Choose 480p, 720p or 1080p. The 1080p limit is 10 seconds; max_frames caps frames and does not guarantee output duration.

cURL

curl --fail-with-body https://www.zzai.app/v1/videos \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"images":["https://your-cdn.example/character.png"],"metadata":{"frame_rate":30,"pose_method":"vitpose","ratio":"adaptive","resolution":"720p","video_url":["https://your-cdn.example/motion.mp4"]},"model":"animate-motion-transfer"}'

Python

import json, os, requests

payload = json.loads(r'''{"images":["https://your-cdn.example/character.png"],"metadata":{"frame_rate":30,"pose_method":"vitpose","ratio":"adaptive","resolution":"720p","video_url":["https://your-cdn.example/motion.mp4"]},"model":"animate-motion-transfer"}''')
response = requests.post(
    "https://www.zzai.app/v1/videos",
    headers={"Authorization": "Bearer " + os.environ["SEEDANCE_API_KEY"]},
    json=payload, timeout=120,
)
response.raise_for_status()
print(response.json()["id"])

JavaScript

const response = await fetch("https://www.zzai.app/v1/videos", {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.SEEDANCE_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({"images":["https://your-cdn.example/character.png"],"metadata":{"frame_rate":30,"pose_method":"vitpose","ratio":"adaptive","resolution":"720p","video_url":["https://your-cdn.example/motion.mp4"]},"model":"animate-motion-transfer"}),
});
if (!response.ok) throw new Error(await response.text());
console.log((await response.json()).id);

Save the returned id as TASK_ID in the query example. Query every 3–5 seconds until success or failure; submission does not mean generation is complete. Save result files promptly. status: completed / failed; metadata.url.

curl --fail-with-body https://www.zzai.app/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

Frequently asked questions

How do I call this model?

Create an API key, choose the model name below, and send a request to the documented OpenAI-compatible endpoint. Final billing follows the current price and usage parameters.