拼长图

将多张图片按顺序竖向拼接为一张长图，可选择是否在每张图片上显示文件名标签。

创建任务

基本信息

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

请求参数（Body）

参数名	类型	必填	默认值	说明
file_ids	array	是	—	图片文件 ID 数组，按顺序从上到下拼接
show_filename	boolean	否	false	是否在每张图片上显示文件名标签

任一张图片读不出时整单失败，不会跳过这一张、少拼一张：认不出是图片的文件在建单时直接返回 6017，不创建任务、不扣费；数据不完整的图片（如下载中断造成的截断）要到任务执行时才发现，此时任务以 6021 失败、积分自动退回，error 会指名是第几张（按 file_ids 顺序从 1 数起）。

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/image_vertical_stitch \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_ids": ["537489015178246", "537489015178247", "537489015178248"],
    "show_filename": false
  }'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178249",
    "task_type": "image_vertical_stitch",
    "status": "queued"
  }
}

---

查询任务结果

基本信息

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

响应参数（output_result）

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

成功响应示例

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

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_ids 缺失	传入 file_ids 参数
6004	404	文件不存在	检查 file_ids 中的 ID 是否正确
6017	400	file_ids 中有文件不是可识别的图片（如伪装成 .jpg 的网页、文件头残缺），整个请求被拒绝，不创建任务、不扣费	逐张检查，把有问题的图片重新导出为 JPEG / PNG 后上传
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值
6021	—	其中一张图片数据不完整或已损坏（常见于下载或上传中断造成的截断），整单失败，error 会指名第几张（任务执行阶段：任务失败、积分退回，错误码见任务结果的 error_code）	重新导出这张图或换用原图后重新提交