Vertical Stitch

Stitch multiple images together vertically in sequence. You can optionally display each file name as a label on the image.

Create Task

Basic Information

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

Request Body

Parameter	Type	Required	Default	Description
file_ids	array	Yes	-	Image file IDs to stitch from top to bottom
show_filename	boolean	No	false	Whether to display the file name on each stitched image section

Request Example

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

Success Example

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

---

Query Task Result

Basic Information

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

Output Result (output_result)

Parameter	Type	Description
file_id	string	Generated stitched image file ID
download_url	string	Download path for the generated image

Success Example

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

Error Codes

Error Code	HTTP Status	Description	Resolution
6013	400	Missing file_ids	Pass the file_ids field
6004	404	File not found	Verify each value in file_ids
6502	401	Authentication failed	Check the Authorization header
6202	402	Insufficient balance	Recharge in the Dashboard