VODAM Motion Analysis API
Analyze exercise and human movement videos through a hosted PINN-based motion representation pipeline. Use precision mode for single-video analysis or compare mode for guide-vs-user exercise scoring.
Precision
Single-video movement interpretation with readable streaming output.
Compare
Guide-vs-user motion comparison with score summaries and feedback.
Formats
Use response_format=pretty, json, or both.
Precision Analysis
Use this mode for a single uploaded video. exercise_type is not required.
curl -N https://api.vodam.ai/v1/motion/analyze/stream \
-H "Authorization: Bearer $VODAM_KEY" \
-F "video=@squat.mp4" \
-F "mode=precision" \
-F "language=Korean" \
-F "analysis_mode=movement"
Example precision result
[Request received.]
[Video upload completed.]
[Analysis started.]
[Analysis completed.]
[Analysis Result]
Request ID: public-stream-precision-...
Mode: precision
Language: Korean
Type: movement
Duration: 8.3s
Intensity: medium
Symmetry: stable
Stability: good
Description:
Lower-body repetitive movement is detected, with knee and pelvis motion appearing as the main movement features.
Guide Comparison
Use this mode to compare a user video against a hosted or uploaded guide video.
curl -N https://api.vodam.ai/v1/motion/analyze/stream \
-H "Authorization: Bearer $VODAM_KEY" \
-F "video=@user_squat.mp4" \
-F "mode=compare" \
-F "exercise_type=squat" \
-F "guide_source=server"
Example compare result
[Request received.]
[Video upload completed.]
[Guide video prepared.]
[Analysis started.]
[Analysis completed.]
[Analysis Result]
Request ID: public-stream-compare-...
Mode: compare
Exercise: squat
Overall score: 82.4 / 100
Posture score: 82.4 / 100
Angle score: 82.4 / 100
Force/flow score: 82.4 / 100
Compared frames: 120
Feedback:
- Overall rhythm is close to the guide, but knee tracking needs more consistency.
- Keep the pelvis path smoother during the lower phase.
Focus metrics:
- left knee coordinate: 71.2 / 100 (caution)
- pelvis velocity: 76.8 / 100 (good)
Machine-readable Output
Use JSON output when integrating with another service or dashboard.
curl -N https://api.vodam.ai/v1/motion/analyze/stream \
-H "Authorization: Bearer $VODAM_KEY" \
-F "video=@user_squat.mp4" \
-F "mode=compare" \
-F "exercise_type=squat" \
-F "guide_source=server" \
-F "response_format=json"
Notice
This is a hosted commercial API. It is not a medical, diagnostic, biometric, or safety-critical system. API access is provided under separate VODAM terms.