CQTAI
Suno · 音乐

上传音频

📌 这是什么：上传一段外部音频，换回一个片段 ID（供其它能力引用）。
💡 什么时候用：想对自己的音频做延伸/翻唱/混搭前，先上传拿到 ID。

接口地址

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

请求参数

参数类型必填说明
taskstring必填固定填 upload
audioUrlstring必填可下载的音频 URL

请求示例

curl -X POST https://api.cqtai.com/api/cqt/generator/suno \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{ "task":"upload", "audioUrl":"https://cdn1.suno.ai/ef8bd9f0-faf2-4e39-a922-ec3f85898ac3.mp3" }'
# -> { "code":200, "data":"<taskId>" }

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "id": "8da0bc5e2f4c48eb86954a1f763470cd",
    "taskType": "upload",
    "status": "succeeded",
    "errorMsg": "",
    "param": {
      "task": "upload",
      "audioUrl": "https://cdn1.suno.ai/ef8bd9f0-faf2-4e39-a922-ec3f85898ac3.mp3"
    },
    "result": {
      "id": "217c547a-3aee-48db-9490-e4182566fe91",
      "title": "ef8bd9f0-faf2-4e39-a922-ec3f85898ac3",
      "handle": "pauliboldenwtan5",
      "status": "complete",
      "user_id": "4bc5457b-4c0a-4ceb-9fbb-0ecdf73dab80",
      "metadata": {
        "tags": "C-Pop, Mandopop. Bright, energetic male vocals … （系统自动分析的风格描述已省略）",
        "type": "upload",
        "prompt": "[Intro] Hey! Hey! Hey! … （自动转写的歌词已省略）",
        "duration": 166.68,
        "is_remix": false,
        "has_vocal": true,
        "uses_latest_model": false,
        "can_publish_with_vocal": true
      },
      "audio_url": "https://cdn1.suno.ai/217c547a-3aee-48db-9490-e4182566fe91.mp3",
      "image_url": "https://cdn2.suno.ai/image_217c547a-3aee-48db-9490-e4182566fe91.jpeg",
      "image_large_url": "https://cdn2.suno.ai/image_large_217c547a-3aee-48db-9490-e4182566fe91.jpeg",
      "video_url": "",
      "media_urls": [
        { "url": "https://d2lwuy8qc234o3.cloudfront.net/1/clip/217c547a-3aee-48db-9490-e4182566fe91.m4a", "delivery": "progressive", "content_type": "m4a-opus" },
        { "url": "https://cdn1.suno.ai/217c547a-3aee-48db-9490-e4182566fe91.mp3", "delivery": "progressive", "content_type": "mp3" }
      ],
      "model_name": "chirp-chirp",
      "batch_index": 0,
      "created_at": "2026-07-08T03:42:17.754Z",
      "display_tags": "C-Pop, Mandopop, upbeat male vocals",
      "major_model_version": ""
    },
    "completeTime": 1783482148259
  }
}

响应字段说明

字段类型说明
codenumber状态码，200 表示成功
msgstring提示信息
data.idstring任务 ID（= 提交时拿到的 taskId）
data.taskTypestring任务类型，恒为 upload
data.statusstring任务状态：pending 处理中 / succeeded 成功 / failed 失败
data.paramobject原样回显你提交的 audioUrl
data.resultobject⚠ 单个 clip 对象（非数组、非 {clip}）——即入库后的音频片段
data.result.idstring🔑 入库后的 clipId——拿去做 upload_extend / upload_cover / mashup
data.result.titlestring标题（默认取文件名）
data.result.audio_urlstring平台转存后的音频地址（mp3）
data.result.image_urlstring自动生成的封面图（image_large_url 为大图）
data.result.statusstring片段状态，complete 表示可用
data.result.metadata.typestring恒为 upload
data.result.metadata.tagsstring系统自动分析出的风格描述
data.result.metadata.promptstring系统自动转写的歌词
data.result.metadata.duration / has_vocalmixed时长（秒）/ 是否含人声
data.result.display_tagsstring精简风格标签
data.result.media_urlsarray多格式音频地址（m4a-opus / mp3）
data.completeTimenumber⚠ 完成时间为毫秒时间戳（数字）；upload 无 createTime 字段

计费与积分

4 积分（链式调用时不单独计费）（× 你的用户费率）。任务失败自动退回。