Smart Collage / Cover

Generate collage or cover layouts from multiple images and title text. Suitable for social content production and cover generation.

Example Outputs

Create Task

Basic Information

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

Request Body

Parameter	Type	Required	Default	Description
file_ids	array	Yes	-	Array of image file IDs
main_title	string	Yes	-	Main title text
sub_title	string	No	""	Subtitle text
mode	string	No	"full"	Generation mode: full, image, or text
aspect	string	No	"3:4"	Aspect ratio, such as "1:1", "3:4", "4:3", "9:16", or "16:9"
quality	string	No	"1080p"	Output quality
output_pic_count	number	No	0	Number of pure-image outputs, up to 20
output_text_count	number	No	1	Number of text-image outputs, up to 20

Request Example

curl -X POST https://api.ai-mcn.tv:10000/task/image_classic_template \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_ids": ["537489015178246", "537489015178247"],
    "main_title": "Highlights",
    "sub_title": "2026 Review",
    "mode": "full",
    "aspect": "3:4",
    "output_text_count": 3
  }'

Success Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178248",
    "task_type": "image_classic_template",
    "status": "queued"
  }
}

---

Query Task Result

Basic Information

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

Output Result (output_result)

Parameter	Type	Description
files	array	Generated cover file list
files[].file_id	string	Generated file ID
files[].download_url	string	Download path for the generated file

Success Example

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

Error Codes

Error Code	HTTP Status	Description	Resolution
6013	400	Missing file_ids or main_title	Add the required fields
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