CQTAI
Suno · 音乐

翻唱

📌 这是什么：用新的风格重新演绎一首已有的歌（旋律保留，换风格/编曲）。
💡 什么时候用：想把一首歌改成爵士、摇滚等不同风格时用。

接口地址

用途方法路径
提交任务POST/api/cqt/generator/suno
查询结果GET/api/cqt/info/suno?id={taskId}

请求参数

参数类型必填说明
taskstring必填固定填 cover
modelstring必填模型版本（推荐 v6）
clipIdstring必填要翻唱的歌曲片段 ID
customModebool—是否自定义模式：true 时 prompt 作精确歌词，false 时作风格描述
promptstring—风格/改编描述，如"变成女声，嗓音偏雷鬼一点"
tagsstring—目标风格标签，如 Hip-Hop/Rap, Happy
titlestring—歌曲标题
vocalGenderenum(m/f)—人声性别：m 男声 / f 女声
makeInstrumentalbool—是否纯伴奏（无人声），默认 false
高级参数（可选）
参数类型说明
styleWeightnumber(0~1)风格权重，越大越贴近 tags 风格
audioWeightnumber(0~1)原音频影响权重（用于基于音频的任务）
weirdnessConstraintnumber(0~1)创意/怪异度，越大越大胆
personaIdstring音色/角色 ID（用声音角色演唱）
artistClipIdstring风格参考片段 ID

请求示例

curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "task": "cover",
    "model": "v6",
    "customMode": false,
    "clipId": "05d72140-38f5-4eb4-bdaa-a6e0d1c1167e",
    "makeInstrumental": false,
    "prompt": "变成女声，然后嗓音偏雷鬼一点",
    "tags": "Hip-Hop/Rap, Happy, Party",
    "title": "Roadtrip Sunrise10",
    "vocalGender": "f",
    "styleWeight": 0.65,
    "weirdnessConstraint": 0.65,
    "audioWeight": 0.65
  }'
# -> { "code":200, "data":"<taskId>" }

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "8bba0b9499ea4fb8984b9d6e3830067a",
    "taskType": "cover",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "cover",
      "model": "chirp-v45",
      "customMode": false,
      "clipId": "05d72140-38f5-4eb4-bdaa-a6e0d1c1167e",
      "makeInstrumental": false,
      "prompt": "变成女声，然后嗓音偏雷鬼一点",
      "tags": "Hip-Hop/Rap, Happy, Party",
      "title": "Roadtrip Sunrise10",
      "vocalGender": "f",
      "styleWeight": 0.65,
      "weirdnessConstraint": 0.65,
      "audioWeight": 0.65
    },
    "result": [
      {
        "id": "a193f365-a099-4089-a877-1b748c0bdb45",
        "title": "Roadtrip Sunrise10",
        "handle": "ernabillstbwsd",
        "status": "complete",
        "user_id": "f04d4d05-dd5c-4f54-ac37-3357099b2ce1",
        "metadata": {
          "key": "C_major",
          "tags": "Hip-Hop/Rap, Happy, Party",
          "task": "cover",
          "type": "gen",
          "prompt": "[Verse 1] 你把窗帘拉开一点 风就跑进我房间 …（完整歌词已省略）",
          "avg_bpm": 108.04,
          "max_bpm": 111.11,
          "min_bpm": 107.14,
          "duration": 81.44,
          "is_remix": true,
          "has_vocal": false,
          "cover_clip_id": "05d72140-38f5-4eb4-bdaa-a6e0d1c1167e",
          "edited_clip_id": "05d72140-38f5-4eb4-bdaa-a6e0d1c1167e",
          "control_sliders": { "audio_weight": 0.65, "style_weight": 0.65, "weirdness_constraint": 0.65 },
          "make_instrumental": false,
          "uses_latest_model": false,
          "can_publish_with_vocal": true,
          "gpt_description_prompt": "变成女声，然后嗓音偏雷鬼一点"
        },
        "audio_url": "https://cdn1.suno.ai/a193f365-a099-4089-a877-1b748c0bdb45.mp3",
        "image_url": "https://cdn2.suno.ai/image_a193f365-a099-4089-a877-1b748c0bdb45.jpeg",
        "image_large_url": "https://cdn2.suno.ai/image_large_a193f365-a099-4089-a877-1b748c0bdb45.jpeg",
        "video_url": "",
        "clip_roots": {
          "clips": [
            { "user_handle": "playfulsubtlety0358", "user_display_name": "PlayfulSubtlety0358", "user_avatar_image_url": "https://cdn1.suno.ai/sAura14.jpg" }
          ],
          "clip_attribution_type": "remix"
        },
        "media_urls": [
          { "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/a193f365-a099-4089-a877-1b748c0bdb45.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
          { "url": "https://cdn1.suno.ai/a193f365-a099-4089-a877-1b748c0bdb45.mp3", "delivery": "progressive", "content_type": "mp3" }
        ],
        "model_name": "chirp-auk",
        "batch_index": 0,
        "created_at": "2026-07-08T06:45:43.752Z",
        "major_model_version": "v4.5"
      },
      {
        "id": "8b157c63-43cf-4714-ad7f-95c40b71c956",
        "title": "Roadtrip Sunrise10",
        "status": "complete",
        "metadata": {
          "key": "Db_major",
          "task": "cover",
          "duration": 162.08,
          "avg_bpm": 108.03,
          "is_remix": true,
          "cover_clip_id": "05d72140-38f5-4eb4-bdaa-a6e0d1c1167e",
          "gpt_description_prompt": "变成女声，然后嗓音偏雷鬼一点"
        },
        "audio_url": "https://cdn1.suno.ai/8b157c63-43cf-4714-ad7f-95c40b71c956.mp3",
        "image_url": "https://cdn2.suno.ai/image_8b157c63-43cf-4714-ad7f-95c40b71c956.jpeg",
        "batch_index": 1,
        "major_model_version": "v4.5"
      }
    ],
    "createTime": "2026-07-08 14:45:41",
    "completeTime": "2026-07-08 14:46:48"
  }
}

响应字段说明

字段类型说明
codenumber状态码，200 表示成功
msgstring提示信息
data.idstring任务 ID（= 提交时拿到的 taskId，用于轮询查询）
data.taskTypestring任务类型，与提交的 task 一致
data.statusstring任务状态：pending 处理中 / succeeded 成功 / failed 失败
data.errorMsgstring失败原因，成功时为空
data.paramobject原样回显你提交的请求参数
data.resultarray生成结果，一次返回 2 条候选片段
data.result[].idstring生成片段的 clipId，可继续用于再次 extend / cover 等
data.result[].audio_urlstring音频文件地址（mp3）
data.result[].video_urlstring视频文件地址（mp4），有时为空需稍后再查
data.result[].image_urlstring封面图地址（image_large_url 为大图）
data.result[].titlestring歌曲标题
data.result[].statusstring片段状态，complete 表示可下载
data.result[].metadata.durationnumber音频总时长（秒）
data.result[].metadata.tagsstring风格标签
data.result[].metadata.keystring调性，如 C_major / Db_major
data.result[].metadata.avg_bpmnumber平均速度 BPM（另有 max_bpm/min_bpm）
data.result[].metadata.has_vocalbool是否含人声
data.result[].metadata.cover_clip_idstring被翻唱的源片段 ID（= 你传的 clipId）
data.result[].metadata.gpt_description_promptstring你输入的风格描述（回显 prompt）
data.result[].metadata.is_remixbool是否二次创作，cover 恒为 true
data.result[].clip_rootsobject源片段（父曲）信息：标题 / 封面 / 作者
data.result[].media_urlsarray多格式音频地址（m4a-opus / mp3）
data.result[].batch_indexnumber候选序号（0、1）
data.result[].major_model_versionstring生成所用模型版本，如 v4.5 / v5.5
data.createTime / completeTimestring任务提交时间 / 完成时间
其它字段—action_config / model_badges / secondary_badges / ownership / avatar_image_url 等为 Suno 前端展示用，可忽略