Suno · Music Generation

Replace Section

📌 What is this：Redo only one part of a song (e.g. the second verse), keeping the rest.

💡 When to use：Use when most of a song is fine but one section needs redoing.

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: replace_section
taskId	string	Required	Task ID the source song belongs to
clipId	string	Required	Source song clip ID
rangeStartS	number	Required	Start second of the section to replace
rangeEndS	number	Required	End second of the section to replace
infillLyrics	string	Required	New lyrics for the replaced section
tags	string	—	Style tags
title	string	—	Song title
infillType	enum	—	smart (default) / classic / fixed

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": "replace_section",
    "taskId": "d649231618784ee4b9cfa059ac50be5e",
    "clipId": "eb1c6c96-a102-4bbb-82c2-87c3b126a44e",
    "tags": "Happy",
    "title": "两只老虎(聪明)",
    "infillLyrics": "两只老虎 两只老虎跑得快 一只没有耳朵 一只没有尾巴 真奇怪",
    "rangeStartS": 7.56,
    "rangeEndS": 15.98
  }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "eb6ef8e92f3a4ef6b05376913349241a",
    "taskType": "create",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "create",
      "model": "chirp-v50",
      "customMode": true,
      "makeInstrumental": false,
      "prompt": "两只老虎 两只老虎跑得快 一只没有耳朵一只没有尾巴真奇怪 ...",
      "tags": "Happy",
      "negativeTags": "Sad, Slow",
      "title": "两只老虎",
      "vocalGender": "f",
      "styleWeight": 0.65,
      "weirdnessConstraint": 0.65,
      "audioWeight": 0.65
    },
    "result": [
      {
        "id": "4f51f49d-8875-442d-9a66-81a7e66d55d6",
        "title": "两只老虎",
        "handle": "playfulsubtlety0358",
        "status": "complete",
        "user_id": "c267a485-9025-44b9-85c1-a9251f0e8f49",
        "explicit": false,
        "has_hook": false,
        "is_liked": false,
        "metadata": {
          "tags": "Happy",
          "type": "gen",
          "prompt": "两只老虎 两只老虎跑得快 ...",
          "stream": true,
          "duration": 91.32,
          "has_stem": false,
          "is_remix": false,
          "priority": 10,
          "can_remix": true,
          "model_badges": {
            "songrow": {
              "dark": { "text_color": "FD429C", "border_color": "00000000", "background_color": "FD429C40" },
              "light": { "text_color": "FD429C", "border_color": "00000000", "background_color": "FD429C1A" },
              "display_name": "v5"
            },
            "songcard": {
              "dark": { "text_color": "FD429C", "border_color": "00000000", "background_color": "0000004D" },
              "light": { "text_color": "FD429C", "border_color": "00000000", "background_color": "0000004D" },
              "display_name": "v5"
            }
          },
          "negative_tags": "Sad, Slow",
          "refund_credits": false,
          "control_sliders": { "audio_weight": 0.65, "style_weight": 0.65, "weirdness_constraint": 0.65 },
          "make_instrumental": false,
          "uses_latest_model": true
        },
        "audio_url": "https://cdn1.suno.ai/4f51f49d-8875-442d-9a66-81a7e66d55d6.mp3",
        "image_url": "https://cdn2.suno.ai/image_4f51f49d-8875-442d-9a66-81a7e66d55d6.jpeg",
        "is_public": false,
        "video_url": "",
        "created_at": "2026-01-09T11:37:27.101Z",
        "flag_count": 0,
        "is_trashed": false,
        "model_name": "chirp-crow",
        "play_count": 0,
        "batch_index": 0,
        "entity_type": "song_schema",
        "display_name": "PlayfulSubtlety0358",
        "upvote_count": 0,
        "comment_count": 0,
        "allow_comments": true,
        "image_large_url": "https://cdn2.suno.ai/image_large_4f51f49d-8875-442d-9a66-81a7e66d55d6.jpeg",
        "is_contest_clip": false,
        "avatar_image_url": "https://cdn1.suno.ai/sAura14.jpg",
        "is_handle_updated": false,
        "major_model_version": "v5"
      },
      {
        "id": "f64bf2bf-d588-4248-b7e9-0367142c945a",
        "title": "两只老虎",
        "handle": "playfulsubtlety0358",
        "status": "complete",
        "user_id": "c267a485-9025-44b9-85c1-a9251f0e8f49",
        "explicit": false,
        "has_hook": false,
        "is_liked": false,
        "metadata": {
          "tags": "Happy",
          "type": "gen",
          "prompt": "两只老虎 两只老虎跑得快 ...",
          "stream": true,
          "duration": 114.96,
          "has_stem": false,
          "is_remix": false,
          "priority": 10,
          "can_remix": true,
          "negative_tags": "Sad, Slow",
          "refund_credits": false,
          "control_sliders": { "audio_weight": 0.65, "style_weight": 0.65, "weirdness_constraint": 0.65 },
          "make_instrumental": false,
          "uses_latest_model": true
        },
        "audio_url": "https://cdn1.suno.ai/f64bf2bf-d588-4248-b7e9-0367142c945a.mp3",
        "image_url": "https://cdn2.suno.ai/image_f64bf2bf-d588-4248-b7e9-0367142c945a.jpeg",
        "is_public": false,
        "video_url": "",
        "created_at": "2026-01-09T11:37:27.101Z",
        "flag_count": 0,
        "is_trashed": false,
        "model_name": "chirp-crow",
        "play_count": 0,
        "batch_index": 1,
        "entity_type": "song_schema",
        "display_name": "PlayfulSubtlety0358",
        "upvote_count": 0,
        "comment_count": 0,
        "allow_comments": true,
        "image_large_url": "https://cdn2.suno.ai/image_large_f64bf2bf-d588-4248-b7e9-0367142c945a.jpeg",
        "is_contest_clip": false,
        "avatar_image_url": "https://cdn1.suno.ai/sAura14.jpg",
        "is_handle_updated": false,
        "major_model_version": "v5"
      }
    ],
    "createTime": "2026-01-09 19:37:16",
    "completeTime": "2026-01-09 19:38:57"
  }
}

Billing & Credits

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