AI Motion Control Generate

API AI Motion Control Generate¶

Tổng quan¶

Tạo video motion control từ ảnh nhân vật + video chuyển động mẫu.

Hướng dẫn & bảng giá¶

Xem dashboard, hướng dẫn sử dụng và bảng giá mới nhất tại: app.revidapi.com

Xác thực¶

Authorization: Bearer sk_live_your_key

1) Tạo Job Motion Control¶

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

Tham số request¶

Tên	Kiểu	Bắt buộc	Mô tả
`character_image_url`	string	Có	URL ảnh nhân vật
`motion_video_url`	string	Có	URL video chuyển động mẫu
`prompt`	string	Không	Prompt bổ sung
`mode`	string	Không	`std` (720p) hoặc `pro` (1080p)
`resolution`	string	Không	`720p` hoặc `1080p` (thay thế cho `mode`)
`model`	string	Không	`motion-control-3.0` hoặc `motion-control-2.6`
`server_id`	string	Không	Server tier, ví dụ: `vip1`, `vip2`

Curl mẫu¶

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"
  }'

Kết quả trả về¶

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

2) Kiểm tra trạng thái Job¶

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

Curl mẫu¶

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

Mã lỗi¶

Code	Lỗi	Mô tả
400	Bad Request	Thiếu tham số hoặc payload/file không hợp lệ.
401	Unauthorized	Thiếu hoặc sai API key.
402	Insufficient Funds	Không đủ credits trong tài khoản.
403	Forbidden	API key không có quyền truy cập tài nguyên này.
404	Not Found	Job/tài nguyên không tồn tại.
429	Too Many Requests	Vượt giới hạn tốc độ (1000 req/phút).
500	Internal Server Error	Lỗi server nội bộ.
503	Service Unavailable	Nhà cung cấp model đang quá tải hoặc bảo trì.