比例转换

将视频转换为指定的目标尺寸，支持多种画布模式及时间段截取，适用于多平台视频尺寸适配。

创建任务

基本信息

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

请求参数（Body）

参数名	类型	必填	默认值	说明
file_id	string	是	—	已上传视频文件的 ID
target_width	number	否	1080	目标视频宽度（像素）
target_height	number	否	1920	目标视频高度（像素）
canvas_type	string	否	"normal"	画布类型：normal（适配）/ rectangle（矩形自适应裁剪）/ square（方形裁剪）
start	number	否	0	截取起始时间（秒，0 表示从头开始）
end	number	否	0	截取结束时间（秒，0 表示到结尾）
need_audio	boolean	否	true	是否保留音频轨道

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/video_canvas_adapt \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "target_width": 1080,
    "target_height": 1920,
    "canvas_type": "normal",
    "need_audio": true
  }'

成功响应示例

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

---

查询任务结果

基本信息

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

响应参数（output_result）

参数名	类型	说明
file_id	string	处理后的视频文件 ID
download_url	string	视频下载路径
original_size	string	原始视频尺寸，如 "1920x1080"
target_size	string	目标尺寸，如 "1080x1920"

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "download_url": "/download/a1/output.mp4",
      "original_size": "1920x1080",
      "target_size": "1080x1920"
    },
    "create_time": "2026-04-05T08:00:00Z",
    "update_time": "2026-04-05T08:00:45Z"
  }
}

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_id 缺失	传入 file_id 参数
6014	400	文件类型与接口不匹配	传入视频文件
6004	404	文件不存在	检查 file_id 是否正确
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值