Suno · Music

Add Instrumental

📌 What is this：Add backing instruments to a chosen section.

💡 When to use：Use when a section has vocals only and you want music behind it.

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: add_instrumental
model	string	Required	Model version
clipId	string	Required	Source clip ID
rangeStartS	number	Required	Start second of the section
rangeEndS	number	Required	End second of the section

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":"add_instrumental", "model":"v55", "clipId":"5751729f-66f7-493c-bf22-4c4cda6cb0bd", "rangeStartS":0, "rangeEndS":30 }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "4314b017c1234f189159b036114bffe7",
    "taskType": "add_instrumental",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "add_instrumental",
      "model": "chirp-v55",
      "clipId": "5751729f-66f7-493c-bf22-4c4cda6cb0bd",
      "rangeStartS": 0,
      "rangeEndS": 30
    },
    "result": [
      {
        "id": "27aa2fc1-aee9-4714-93a1-3555e70a629f",
        "title": "",
        "handle": "roselinhobbui3xs",
        "status": "complete",
        "user_id": "643d21e5-da6b-421c-ad4c-fa10b8bfdc90",
        "metadata": {
          "tags": "",
          "task": "underpainting",
          "type": "gen",
          "prompt": "",
          "avg_bpm": 120.85,
          "max_bpm": 136.36,
          "min_bpm": 65.22,
          "duration": 189.76,
          "is_remix": true,
          "make_instrumental": false,
          "uses_latest_model": true,
          "underpainting_clip_id": "5751729f-66f7-493c-bf22-4c4cda6cb0bd"
        },
        "audio_url": "https://cdn1.suno.ai/27aa2fc1-aee9-4714-93a1-3555e70a629f.mp3",
        "image_url": "https://cdn2.suno.ai/image_27aa2fc1-aee9-4714-93a1-3555e70a629f.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_large_27aa2fc1-aee9-4714-93a1-3555e70a629f.jpeg",
        "video_url": "",
        "clip_roots": {
          "clips": [
            {
              "id": "5751729f-66f7-493c-bf22-4c4cda6cb0bd",
              "title": "Emanuel filho amado",
              "image_url": "https://cdn2.suno.ai/image_5751729f-66f7-493c-bf22-4c4cda6cb0bd.jpeg",
              "user_handle": "roselinhobbui3xs",
              "user_display_name": "roselinhobbui3xs"
            }
          ],
          "clip_attribution_type": "remix"
        },
        "media_urls": [
          { "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/27aa2fc1-aee9-4714-93a1-3555e70a629f.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
          { "url": "https://cdn1.suno.ai/27aa2fc1-aee9-4714-93a1-3555e70a629f.mp3", "delivery": "progressive", "content_type": "mp3" }
        ],
        "model_name": "chirp-fenix",
        "batch_index": 0,
        "created_at": "2026-07-09T01:29:21.141Z",
        "major_model_version": "v5.5"
      },
      {
        "id": "bb675229-2b4e-499c-add0-d58e4326ba75",
        "title": "",
        "status": "complete",
        "metadata": {
          "task": "underpainting",
          "type": "gen",
          "duration": 183.6,
          "is_remix": true,
          "underpainting_clip_id": "5751729f-66f7-493c-bf22-4c4cda6cb0bd"
        },
        "audio_url": "https://cdn1.suno.ai/bb675229-2b4e-499c-add0-d58e4326ba75.mp3",
        "image_url": "https://cdn2.suno.ai/image_bb675229-2b4e-499c-add0-d58e4326ba75.jpeg",
        "batch_index": 1,
        "major_model_version": "v5.5"
      }
    ],
    "createTime": "2026-07-09 09:29:16",
    "completeTime": "2026-07-09 09:31:56"
  }
}

Response Fields

Field	Type	Description
code	number	Status code; 200 = success
msg	string	Message
data.id	string	Task ID (the taskId returned on submit; used to poll)
data.taskType	string	Task type; matches the submitted task
data.status	string	Status: pending / succeeded / failed
data.errorMsg	string	Failure reason; empty on success
data.param	object	Echo of the request params you submitted
data.result	array	Results; returns 2 candidate clips
data.result[].id	string	The generated clipId; reusable for further extend / cover, etc.
data.result[].audio_url	string	Audio file URL (mp3)
data.result[].video_url	string	Video file URL (mp4); may be empty, re-query later
data.result[].image_url	string	Cover image URL (image_large_url is the large one)
data.result[].title	string	Song title
data.result[].status	string	Clip status; "complete" = ready to download
data.result[].metadata.duration	number	Total audio duration (seconds)
data.result[].metadata.tags	string	Style tags
data.result[].metadata.task	string	For add_instrumental, the clip metadata.task shows "underpainting"
data.result[].metadata.underpainting_clip_id	string	Source clip ID the instrumental was added to (= the clipId you passed)
data.result[].metadata.avg_bpm	number	Average tempo in BPM (also max_bpm/min_bpm)
data.result[].metadata.is_remix	bool	Whether it is a remix; always true for add_instrumental
data.result[].clip_roots	object	Source (parent) clip info: title / cover / author
data.result[].media_urls	array	Multi-format audio URLs (m4a-opus / mp3)
data.result[].batch_index	number	Candidate index (0, 1)
data.result[].major_model_version	string	Model version used, e.g. v4.5 / v5.5
data.createTime / completeTime	string	Task submit time / completion time
其它字段	—	action_config / model_badges / secondary_badges / ownership / avatar_image_url, etc. are for Suno UI and can be ignored

Billing & Credits

30 credits (x your user rate). Auto-refunded on failure.