Stabilisation

This function allows you to stabilise your video streams. Often camera shake causes visible frame-to-frame jitter in the video. This image filter compensates for pan and tilt (angular movement, equivalent to yaw and pitch) of the imaging device and returns a stabilised video stream.

How to Stabilise a Video Stream

To stabilise your video stream simply POST your video clip to this service.

POST /enhance/stabilisation
POST /enhance/stabilisation/ HTTP/1.1
Host: api.videoai.net
Authorization: Basic XXXXX

Example request:

$ curl -L -H "Authorization: Basic XXXX" -F video=@shaky.avi  http://api.videoai.net/enhance/stabilisation

Example response:

HTTP/1.0 200 OK
Content-Type: application/json
Content-Length: 213
Server: Werkzeug/0.11.4 Python/2.7.10
Date: Tue, 19 Apr 2016 13:07:43 GMT
{
    "status": "success",
    "task": {
        "analytic": "enhance",
        "complete": false,
        "job_id": "SPvQpynRe97bVZLLvtGsPm",
        "message": "In progress.",
        "start_time": "Tue, 19 Apr 2016 13:07:43 GMT"
    }
}

Check Job Status

Get the status of your requested stabilisation job.

GET /enhance/(string: job_id)
GET /enhance/(string:job_id) HTTP/1.1
Host: api.videoai.net
Authorization: Basic XXXXX

Example request:

$ curl -L -H "Authorization: Basic XXXX" http://api.videoai.net/enhance/wSPvQpynRe97bVZLLvtGsPm

Example response:

HTTP/1.0 200 OK
Content-Type: application/json
Content-Length: 640
Server: Werkzeug/0.11.4 Python/2.7.10
Date: Tue, 19 Apr 2016 13:07:48 GMT
{
"status": "success",
"task": {
    "algorithm": "stabilisation",
    "analytic": "enhance",
    "complete": true,
    "finish_time": "Tue, 19 Apr 2016 13:07:48 GMT",
    "fps": 12.0,
    "frames": 669,
    "frames_processed": -1,
    "height": 200,
    "input_video": "vegetation.avi",
    "job_id": "SPvQpynRe97bVZLLvtGsPm",
    "message": "Stabilised video",
    "resolution": "352x200@12.0fps",
    "results_video": "http://192.168.90.53:5000/results/110/SPvQpynRe97bVZLLvtGsPm/enhance_SPvQpynRe97bVZLLvtGsPm.mp4",
    "start_frame": 0,
    "start_time": "Tue, 19 Apr 2016 13:07:43 GMT",
    "success": true,
    "width": 352
    }
}