Image Camera Move

Convert a static image into a short video with push, pull, pan, and move camera effects.

Before / After

Create Task

Basic Information

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

Request Body

Parameter	Type	Required	Default	Description
file_id	string	Yes	-	Uploaded image file ID
width	number	No	1920	Output video width in pixels, up to 10000
height	number	No	1080	Output video height in pixels, up to 10000
duration	number	No	8	Video duration in seconds, up to 12
fps	number	No	60	Frame rate, up to 60 fps
motion	string	No	-	Camera move style, see the table below. When omitted, the server picks one automatically (composition analysis + subject detection + randomness); when specified, reruns with the same image and parameters produce the same move

Camera Move Styles (motion values)

Pan (8 values, each describes the direction of movement)

Value	Effect
up_to_down / down_to_up	Pan downward / upward
left_to_right / right_to_left	Pan rightward / leftward
left_up_to_right_down / right_down_to_left_up	Diagonal: top-left → bottom-right / bottom-right → top-left
right_up_to_left_down / left_down_to_right_up	Diagonal: top-right → bottom-left / bottom-left → top-right

Zoom in (9 values, each describes the anchor position on the canvas)

Value	Effect
zoom_in_center	Zoom in anchored at the center
zoom_in_up / zoom_in_down / zoom_in_left / zoom_in_right	Zoom in anchored at an edge midpoint
zoom_in_left_up / zoom_in_right_up / zoom_in_left_down / zoom_in_right_down	Zoom in anchored at a corner

Zoom out (9 values, same anchor positions)

Value	Effect
zoom_out_center	Zoom out anchored at the center
zoom_out_up / zoom_out_down / zoom_out_left / zoom_out_right	Zoom out anchored at an edge midpoint
zoom_out_left_up / zoom_out_right_up / zoom_out_left_down / zoom_out_right_down	Zoom out anchored at a corner

Request Example

curl -X POST https://api.ai-mcn.tv:10000/task/image_move \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "width": 1920,
    "height": 1080,
    "duration": 8,
    "fps": 60,
    "motion": "zoom_in_center"
  }'

Success Example

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

---

Query Task Result

Basic Information

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

Output Result (output_result)

Parameter	Type	Description
file_id	string	Generated video file ID
download_url	string	Download path for the generated 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:00: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 an image file
6016	400	Unsupported motion value	Use a value from the Camera Move Styles table above
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