AI Motion Control Generate

API Motion Control Generate¶

Motion Control lấy chuyển động từ một video mẫu và áp lên nhân vật/ảnh của bạn.

Cùng cơ chế bất đồng bộ như tạo video:

POST /v1/motion/generate → nhận job_id
GET /v1/video/jobs/{job_id} cho tới khi xong
failed → credit được hoàn tự động

Cổng tự chọn đường theo loại model, nên POST /v1/video/generate với model motion cũng chạy đúng. Giữ /v1/motion/generate cho mã cũ.

Địa chỉ và xác thực¶

https://revidapi.com/v1

Authorization: Bearer sk_...

Model¶

Model	Ghi chú
`motion-control-2.6`	Bản gọn
`motion-control-3.0`	Bản mới hơn

Kiểm tra model còn bán và giá từng cấu hình:

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

1) Tạo job¶

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

Tên	Kiểu	Bắt buộc	Mô tả
`model`	string	Có	`motion-control-2.6` hoặc `motion-control-3.0`
`prompt`	string	Có	Mô tả cảnh
`video_url`	string	Có	Video mẫu lấy chuyển động
`img_url`	string \| mảng	Không	Ảnh nhân vật/tham chiếu
`resolution`	string	Không	Theo cấu hình model có
`aspect_ratio`	string	Không	`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": "nhân vật nhảy theo điệu nhạc, nền studio",
    "video_url": "https://example.com/dieu-nhay.mp4",
    "img_url": "https://example.com/nhan-vat.jpg",
    "resolution": "720p"
  }'

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

2) Hỏi trạng thái¶

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

Trả về giống hệt API Tạo Video AI — running, rồi completed kèm result, hoặc failed kèm error.

Mã lỗi¶

Mã	Ý nghĩa
`400`	Thiếu `model`/`prompt`/`video_url`, hoặc cấu hình không có
`401`	Khoá sai hoặc thiếu
`402`	Không đủ credit
`404`	Không bán model đó