AI Motion Control Generate

Motion Control Generate API

Motion Control takes the motion from a reference video and applies it to your character or image.

Same asynchronous flow as video generation:

1. POST /v1/motion/generate → returns a job_id
2. GET /v1/video/jobs/{job_id} until it finishes
3. failed → credits are refunded automatically

The gateway routes by model type, so POST /v1/video/generate with a motion model also works. /v1/motion/generate is kept for existing code.

---

Base URL and authentication

https://revidapi.com/v1

Authorization: Bearer sk_...

---

Models

Model	Notes
motion-control-2.6	Lighter version
motion-control-3.0	Newer version

Check availability and per-configuration pricing:

curl https://revidapi.com/v1/video/models -H "Authorization: Bearer sk_..."

---

1) Create a job

• Method: POST
• URL: https://revidapi.com/v1/motion/generate
• Content-Type: application/json

Name	Type	Required	Description
model	string	Yes	motion-control-2.6 or motion-control-3.0
prompt	string	Yes	Scene description
video_url	string	Yes	Reference video providing the motion
img_url	string | array	No	Character / reference image
resolution	string	No	Whatever the model sells
aspect_ratio	string	No	16:9, 9:16, 1:1

curl -X POST https://revidapi.com/v1/motion/generate \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "motion-control-3.0",
    "prompt": "the character dances to the music, studio background",
    "video_url": "https://example.com/dance.mp4",
    "img_url": "https://example.com/character.jpg",
    "resolution": "720p"
  }'

{
  "job_id": "job_vid_...",
  "status": "pending",
  "cost": 15,
  "poll": "/v1/video/jobs/job_vid_..."
}

---

2) Poll the job

curl https://revidapi.com/v1/video/jobs/job_vid_... \
  -H "Authorization: Bearer sk_..."

The shape is identical to AI Video Generate — running, then completed with result, or failed with error.

---

Error codes

Code	Meaning
400	Missing model/prompt/video_url, or unsold configuration
401	Wrong or missing key
402	Not enough credits
404	That model is not sold