AI Motion Control Generate

AI Motion Control Generate API¶

Overview¶

Generate motion-control video from a character image and a motion reference video.

Guide & Pricing¶

See dashboard, usage guide, and latest pricing at: app.revidapi.com

Authentication¶

Authorization: Bearer sk_live_your_key

1) Create Motion Job¶

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

Request parameters¶

Name	Type	Required	Description
`character_image_url`	string	Yes	Character image URL
`motion_video_url`	string	Yes	Motion reference video URL
`prompt`	string	No	Extra motion prompt
`mode`	string	No	`std` (720p) or `pro` (1080p)
`resolution`	string	No	`720p` or `1080p` (alternative to `mode`)
`model`	string	No	`motion-control-3.0` or `motion-control-2.6`
`server_id`	string	No	Server tier, e.g. `vip1`, `vip2`

Curl example¶

curl -X POST https://ai.revidapi.com/v1/motion/generate \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "https://cdn.revidapi.com/inputs/...",
    "motion_video_url": "https://cdn.revidapi.com/inputs/...",
    "model": "motion-control-3.0",
    "mode": "pro"
  }'

Create response example¶

{
  "job_id": "job_motion_123",
  "status": "pending"
}

2) Check Job Status¶

Method: GET
URL: https://ai.revidapi.com/v1/jobs/{job_id}

Curl example¶

curl -X GET "https://ai.revidapi.com/v1/jobs/job_motion_123" \
  -H "Authorization: Bearer sk_live_your_key"

Error Codes¶

Code	Error	Description
400	Bad Request	Missing params or invalid payload/file format.
401	Unauthorized	Missing or invalid API key.
402	Insufficient Funds	Not enough credits in your account.
403	Forbidden	API key has no permission for this resource.
404	Not Found	Requested job/resource does not exist.
429	Too Many Requests	Rate limit exceeded (1000 req/min).
500	Internal Server Error	Internal server error.
503	Service Unavailable	Model provider is overloaded or under maintenance.