Takes API
The Takes API allows you to retrieve processed motion capture data and results from completed jobs.
Get take details
Retrieve motion capture data for a completed job.
curl -X GET https://api.move.ai/v1/takes/take_123456789 \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"id": "take_123456789",
"job_id": "job_123456789",
"file_id": "file_123456789",
"status": "completed",
"model": "s1",
"created_at": "2023-01-01T00:00:00Z",
"duration": 30.5,
"frame_count": 915,
"download_url": "https://api.move.ai/v1/takes/take_123456789/download"
}
Download motion capture data
Download the processed motion capture data files.
curl -X GET https://api.move.ai/v1/takes/take_123456789/download \
-H "Authorization: Bearer YOUR_API_KEY" \
-o motion_data.zip
Available Formats
- FBX: Autodesk FBX format for 3D software
- BVH: BioVision Hierarchy format
- USDC: Binary USD format for 3D pipelines
- USDZ: Compressed USD format for iOS and AR applications
- GLB: GL Binary format for web and mobile applications
- Blend: Native Blender format
- C3D: Coordinate 3D format for motion analysis
- JSON: Raw motion capture data in JSON format
- CSV: Motion capture data in CSV format
- Render Video: Preview video of motion capture data
- Render Overlay Video: Preview video with motion data overlaid (single camera only)
- Sync Data: Timing information about video offsets
List takes
Get a list of all your processed takes.
curl -X GET https://api.move.ai/v1/takes \
-H "Authorization: Bearer YOUR_API_KEY"
Query Parameters
| Parameter | Type | Description |
|---|---|---|
limit | Integer | Number of takes to return (default: 20, max: 100) |
offset | Integer | Number of takes to skip |
model | String | Filter by AI model used |
Response
{
"takes": [
{
"id": "take_123456789",
"job_id": "job_123456789",
"file_id": "file_123456789",
"status": "completed",
"model": "s1",
"created_at": "2023-01-01T00:00:00Z",
"duration": 30.5
}
],
"total": 1,
"limit": 20,
"offset": 0
}
Delete a take
Delete a take and its associated motion capture data.
curl -X DELETE https://api.move.ai/v1/takes/take_123456789 \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"success": true,
"message": "Take deleted successfully"
}
Take statuses
| Status | Description |
|---|---|
processing | Take is being generated |
completed | Take is ready for download |
failed | Take generation failed |
Motion capture data structure
The motion capture data includes:
- Joint positions: 3D coordinates for each joint
- Joint rotations: Quaternion rotations for each joint
- Timestamps: Frame-by-frame timing information
- Metadata: Video information and processing details