Suno · Music

Cover ImageNEW

📌 What is this：Generate a cover image for your song.

💡 When to use：Use when you need artwork to publish a song.

Endpoints

Usage	Method	Path
Submit task	POST	/api/cqt/generator/suno
Query Result	GET	/api/cqt/info/suno?id={taskId}

Request Parameters

Param	Type	Required	Description
task	string	Required	Fixed value: imageGenerate
prompt	string	Required	Cover image description
imageGenCategory	string	—	basic (default, 2) / advanced (80)

Request Example

curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{ "task":"imageGenerate", "prompt":"album cover, neon city", "imageGenCategory":"basic" }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "127e087bf2f545e7b0ea9547f6f70311",
    "taskType": "imageGenerate",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "imageGenerate",
      "prompt": "album cover, neon city",
      "imageGenCategory": "basic"
    },
    "result": {
      "items": [
        {
          "id": "343a8b4f-3320-44f1-90d6-fb160cee3c8d",
          "url": "https://cdn1.suno.ai/image_large_fc2533f8-21f2-44ef-adba-261c9115e317.jpeg",
          "type": "image",
          "title": "Neon Skyline Echoes",
          "prompt": "album cover, neon city",
          "status": "complete",
          "batch_id": "6d822d53-7047-4abd-a7b6-ec9ef67042ae",
          "created_at": "2026-07-09T02:07:07.714624+00:00",
          "gen_category": "Basic",
          "display_order": 0,
          "thumbnail_url": "https://cdn1.suno.ai/image_large_fc2533f8-21f2-44ef-adba-261c9115e317.jpeg"
        },
        {
          "id": "35f03d88-c2b8-4ca0-b940-c2d3a0e2215f",
          "url": "https://cdn1.suno.ai/image_large_ffde392b-0ee8-4cba-aa07-9ca40a4e5d20.jpeg",
          "type": "image",
          "title": "Neon Skyline Echoes",
          "prompt": "album cover, neon city",
          "status": "complete",
          "batch_id": "6d822d53-7047-4abd-a7b6-ec9ef67042ae",
          "gen_category": "Basic",
          "display_order": 1,
          "thumbnail_url": "https://cdn1.suno.ai/image_large_ffde392b-0ee8-4cba-aa07-9ca40a4e5d20.jpeg"
        }
      ],
      "batch_id": "6d822d53-7047-4abd-a7b6-ec9ef67042ae"
    },
    "createTime": "2026-07-09 10:07:04",
    "completeTime": "2026-07-09 10:07:41"
  }
}

Response Fields

Field	Type	Description
code	number	Status code; 200 = success
msg	string	Message
data.id	string	Task ID (the taskId returned on submit)
data.taskType	string	Task type; always "imageGenerate"
data.status	string	Status: pending / succeeded / failed
data.param	object	Echo of the request params you submitted
data.result	object	⚠ An object { items, batch_id } (not an array); images live under result.items
data.result.batch_id	string	Batch ID (shared by this batch of images)
data.result.items	array	Generated cover images (usually 2 candidates)
data.result.items[].url	string	Image URL (large jpeg)
data.result.items[].thumbnail_url	string	Thumbnail URL
data.result.items[].type	string	Asset type; always "image"
data.result.items[].title	string	AI-generated title
data.result.items[].gen_category	string	Generation tier: Basic / Advanced
data.result.items[].display_order	number	Display order (0, 1)
data.result.items[].status	string	Per-image status; "complete" = ready
data.createTime / completeTime	string	Task submit time / completion time

Billing & Credits

basic 2 credits / advanced 80 credits (x your user rate). Auto-refunded on failure.