CQTAI
Suno · 音乐

生成歌词

📌 这是什么：只生成歌词文字（不出歌）。
💡 什么时候用：需要歌词灵感、或先写词再谱曲时用。

接口地址

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

请求参数

参数类型必填说明
taskstring必填固定填 lyrics
promptstring必填歌词主题描述

请求示例

curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{ "task":"lyrics", "prompt":"A happy song about a girl and a boy." }'
# -> { "code":200, "data":"<taskId>" }

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "ff501471da4649848314f29a5da3bb1e",
    "taskType": "lyrics",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "lyrics",
      "prompt": "A happy song about a girl and a boy."
    },
    "result": [
      {
        "tags": ["upbeat, pop, tropical, male vocals", "happy"],
        "text": "[Verse] Summer kisses Strawberry limeade … （完整歌词已省略）",
        "title": "Summer Kisses",
        "status": "complete",
        "error_message": ""
      },
      {
        "tags": ["pop, fun, male vocals", "happy"],
        "text": "[Verse] Baby blue skies I see you and I … （完整歌词已省略）",
        "title": "True",
        "status": "complete",
        "error_message": ""
      }
    ],
    "createTime": "2026-07-08 17:14:49",
    "completeTime": "2026-07-08 17:14:59"
  }
}

响应字段说明

字段类型说明
codenumber状态码，200 表示成功
msgstring提示信息
data.idstring任务 ID（= 提交时拿到的 taskId）
data.taskTypestring任务类型，恒为 lyrics
data.statusstring任务状态：pending 处理中 / succeeded 成功 / failed 失败
data.paramobject原样回显你提交的请求参数
data.resultarray⚠ 数组，但每项是歌词对象（无音频/clip），一般 2 条候选
data.result[].titlestringAI 起的歌名
data.result[].textstring歌词正文（含 [Verse]/[Chorus] 等段落标记）
data.result[].tagsstring[]建议的风格标签（可直接喂给 create 的 tags）
data.result[].statusstring该条歌词状态，complete 表示可用
data.result[].error_messagestring该条失败原因，成功为空
data.createTime / completeTimestring任务提交时间 / 完成时间

计费与积分

1 积分（× 你的用户费率）。任务失败自动退回。