生成音乐

POST

https://api.ccapi.ai//suno/submit/MUSIC

通过文字描述或自定义歌词生成音乐。

CCAPI 任务流程

提交 -> POST /suno/submit/MUSIC -> {"code":"success","data":"task_xxx"}

查询 -> GET /suno/fetch/{id} 或 POST /suno/fetch -> 查看 data.status 和 data.data

完成 -> 当 data.status = "SUCCESS" 时，data.data 包含归一化的结果数据

计费

参考价格：$0.08

实际扣费以当前 CCAPI 定价、分组倍率和渠道配置为准

失败任务自动退费

注意事项

使用 Authorization: Bearer <CCAPI token> 鉴权

提交接口返回公开的 task_xxx ID，不暴露上游任务 ID

查询接口返回 CCAPI 持久化的任务记录（TaskDto），包含归一化的 data 数据

简单模式（custom=false）下，只需传入 prompt 作为歌曲描述即可

请求参数

Authorization

Body 参数application/json

示例

简单模式（AI 生成歌词）自定义模式（用户提供歌词）Instrumental (no vocals)Advanced Options

{
    "custom": false,
    "mv": "chirp-v4",
    "prompt": "A cheerful pop song about coding and debugging"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

简单模式（AI 生成歌词）自定义模式（用户提供歌词）Instrumental (no vocals)Advanced Options

curl --location --request POST 'https://api.ccapi.ai//suno/submit/MUSIC' \
--header 'Content-Type: application/json' \
--data-raw '{
    "custom": false,
    "mv": "chirp-v4",
    "prompt": "A cheerful pop song about coding and debugging"
}'

返回响应

🟢200成功

application/json

Task submitted

Body

示例

{
    "code": "success",
    "message": "task submitted successfully",
    "data": "task_7f11c4b772f44710ac0fae0d5b3dc4c1"
}

🟠400请求有误

🟠401未认证

🟠403权限不足

🔴500服务器内部错误

修改于 2026-03-27 07:49:07

批量查询任务

查询任务状态