图片运镜

将静态图片转换为具有「推拉摇移」运镜效果的短视频，让图片内容更生动，适合短视频平台发布。

处理前 / 处理后

创建任务

基本信息

项目	值
请求方法	POST
请求路径	/task/image_move
Content-Type	application/json
鉴权方式	Authorization 请求头（直接传 API Key）

请求参数（Body）

参数名	类型	必填	默认值	说明
file_id	string	是	—	已上传图片文件的 ID
width	number	否	1920	输出视频宽度（像素，最大 10000）
height	number	否	1080	输出视频高度（像素，最大 10000）
duration	number	否	8	视频时长（秒，时长范围 2-12 秒）
fps	number	否	60	视频帧率（最高 60 fps）
motion	string	否	—	运镜方式，取值见下表。不传时由服务端自动选择（构图分析 + 主体识别 + 随机）；显式指定后同图同参重跑结果一致

运镜方式（motion 取值）

平移（8 种，值表示运动朝向）

取值	效果
up_to_down / down_to_up	画面向下 / 向上平移
left_to_right / right_to_left	画面向右 / 向左平移
left_up_to_right_down / right_down_to_left_up	对角线：左上 → 右下 / 右下 → 左上
right_up_to_left_down / left_down_to_right_up	对角线：右上 → 左下 / 左下 → 右上

放大（9 种，值表示画布上的缩放锚点方位）

取值	效果
zoom_in_center	以画面中心为锚点推近
zoom_in_up / zoom_in_down / zoom_in_left / zoom_in_right	以四边中点为锚点推近
zoom_in_left_up / zoom_in_right_up / zoom_in_left_down / zoom_in_right_down	以四角为锚点推近

缩小（9 种，锚点方位同放大）

取值	效果
zoom_out_center	以画面中心为锚点拉远
zoom_out_up / zoom_out_down / zoom_out_left / zoom_out_right	以四边中点为锚点拉远
zoom_out_left_up / zoom_out_right_up / zoom_out_left_down / zoom_out_right_down	以四角为锚点拉远

请求示例

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"
  }'

成功响应示例

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

---

查询任务结果

基本信息

项目	值
请求方法	GET
请求路径	/task/image_move/{task_id}
鉴权方式	Authorization 请求头（直接传 API Key）

响应参数（output_result）

参数名	类型	说明
file_id	string	生成的视频文件 ID
download_url	string	视频下载路径

成功响应示例

{
  "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"
  }
}

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_id 缺失	传入 file_id 参数
6014	400	文件类型与接口不匹配	传入图片文件
6016	400	motion 取值不在支持范围	按上方「运镜方式」表传值
6004	404	文件不存在	检查 file_id 是否正确
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值