去除黑边

自动检测并裁剪去除图片四周的黑色边框，还原图片有效内容区域。

创建任务

基本信息

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

请求参数（Body）

参数名	类型	必填	默认值	说明
file_id	string	是	—	已上传图片文件的 ID

请求示例

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

成功响应示例

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

---

查询任务结果

基本信息

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

路径参数

参数名	类型	必填	说明
task_id	string	是	创建任务时返回的任务 ID

请求示例

curl -X GET https://api.ai-mcn.tv:10000/task/image_blackborder_remove/537489015178247 \
  -H "Authorization: YOUR_API_KEY"

响应参数（output_result）

任务完成（status: "completed"）后，output_result 包含以下字段：

参数名	类型	说明
file_id	string	处理后的图片文件 ID
original_size	string	原始图片尺寸，如 "1920x1080"
cropped_size	string	裁剪后的图片尺寸，如 "1920x1050"
removed_borders.top	number	裁剪的顶部像素数
removed_borders.bottom	number	裁剪的底部像素数
removed_borders.left	number	裁剪的左侧像素数
removed_borders.right	number	裁剪的右侧像素数

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "file_id": "537489015178248",
      "original_size": "1920x1080",
      "cropped_size": "1920x1050",
      "removed_borders": {
        "top": 15,
        "bottom": 15,
        "left": 0,
        "right": 0
      }
    },
    "create_time": "2026-04-05T08:00:00Z",
    "update_time": "2026-04-05T08:00:05Z"
  }
}

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_id 缺失	传入 file_id 参数
6014	400	文件类型与接口不匹配	传入图片文件
6004	404	文件不存在	检查 file_id 是否正确
6017	400	文件不是可识别的图片（如伪装成 .jpg 的网页、文件头残缺），建单时直接拒绝，不创建任务、不扣费	重新导出为 JPEG / PNG 后上传
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值
6017	—	图片的实际格式本接口读不了（如扩展名是 .jpg、内容是 AVIF），error 会点名实际格式（任务执行阶段：任务失败、积分退回，错误码见任务结果的 error_code）	转成 JPEG / PNG 后重新上传并提交
6021	—	图片数据不完整或已损坏，常见于下载或上传中断造成的截断；这类图片文件头完好，建单时查不出（任务执行阶段：任务失败、积分退回，错误码见任务结果的 error_code）	重新导出或换用原图后重新提交

下一步

• 比例转换
• 去水印