CQTAI
Suno · 音乐

导出 MP4 / WAV / 时间轴 / 节拍

📌 这是什么：把歌曲导出成视频(MP4)、无损音频(WAV)，或获取歌词时间轴/节拍数据。
💡 什么时候用：需要下载成品或拿到时间轴做字幕时用。注：创作类任务成功后系统会自动免费生成这些，通常无需重复提交。

接口地址

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

请求参数

参数类型必填说明
taskstring必填mp4 / wav / timeline / downbeats 之一
clipIdstring必填源片段 ID

请求示例

curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{ "task":"mp4", "clipId":"clip_abc123" }'
# -> { "code":200, "data":"<taskId>" }

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "0ccf746e2ebb409dbaf5cda7540981d6",
    "taskType": "timeline",
    "status": "succeeded",
    "errorMsg": "",
    "param": { "task": "timeline", "clipId": "e1a78bfe-2e53-4207-9cd8-c764c4bfc621" },
    "result": {
      "aligned_words": [
        { "word": "[Verse 1]\nRed ", "success": true, "start_s": 9.09574, "end_s": 9.33511, "p_align": 0.99 },
        { "word": "eyes ",  "success": true, "start_s": 9.43484, "end_s": 9.73404, "p_align": 0.99 },
        { "word": "from ",  "success": true, "start_s": 9.77394, "end_s": 9.89362, "p_align": 0.99 },
        { "word": "the ",   "success": true, "start_s": 9.94681, "end_s": 10.05319, "p_align": 0.99 },
        { "word": "long ",  "success": true, "start_s": 10.11303, "end_s": 10.29255, "p_align": 0.99 },
        { "word": "night\n", "success": true, "start_s": 10.3883, "end_s": 11.48936, "p_align": 0.99 }
      ]
    }
  }
}

响应字段说明

字段类型说明
codenumber状态码，200 表示成功
msgstring提示信息
data.idstring任务 ID（= 提交时拿到的 taskId，用于轮询查询）
data.taskTypestring任务类型，随提交的 task：mp4 / wav / timeline / downbeats
data.statusstring任务状态：pending 处理中 / succeeded 成功 / failed 失败
data.errorMsgstring失败原因，成功时为空
data.paramobject原样回显你提交的请求参数
data.resultobject结果对象，形态随 task 而定：mp4/wav 为对应文件地址，downbeats 为节拍数据，timeline 为逐词时间轴
data.result.aligned_wordsarray（task=timeline）逐词时间轴数组，每词一条
data.result.aligned_words[].wordstring词/字（含换行与段落标记，如 [Verse 1]）
data.result.aligned_words[].start_s / end_snumber该词的起止时间（秒）
data.result.aligned_words[].p_alignnumber对齐置信度（0~1）

计费与积分

各 2 积分（自动生成的不额外计费）（× 你的用户费率）。任务失败自动退回。