Video Stabilization

Use stabilization algorithms to reduce handheld shake and motion blur. The current implementation provides three stabilization methods.

Create Task

Basic Information

Item	Value
Request Method	POST
Request Path	/task/video_stabilizer
Content-Type	application/json
Authentication	Raw API key in the Authorization header

Request Body

Parameter	Type	Required	Default	Description
file_id	string	Yes	-	Uploaded video file ID
method	string	No	"turbo"	Stabilization method: turbo, fast, or exp

method Meanings

Value	Description
turbo	Recommended default model and currently the most stable option
fast	Faster model with lower latency
exp	Experimental model with higher quality potential, but may introduce visible stretching artifacts

Request Example

curl -X POST https://api.ai-mcn.tv:10000/task/video_stabilizer \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "method": "turbo"
  }'

Success Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "video_stabilizer",
    "status": "queued"
  }
}

---

Query Task Result

Basic Information

Item	Value
Request Method	GET
Request Path	/task/video_stabilizer/{task_id}
Authentication	Raw API key in the Authorization header

Output Result (output_result)

Parameter	Type	Description
file_id	string	Processed video file ID
download_url	string	Download path for the processed video

Success Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "download_url": "/download/a1/output.mp4"
    },
    "create_time": "2026-04-05T08:00:00Z",
    "update_time": "2026-04-05T08:01:20Z"
  }
}

Error Codes

Error Code	HTTP Status	Description	Resolution
6013	400	Missing file_id	Pass the file_id field
6014	400	File type does not match the task	Upload a video file
6004	404	File not found	Verify the file_id
6502	401	Authentication failed	Check the Authorization header
6202	402	Insufficient balance	Recharge in the Dashboard