创建声音角色(暂不可用)

POST

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

创建自定义声音角色，用于后续生成。

CCAPI 任务流程

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

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

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

计费

参考价格：$0

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

失败任务自动退费

注意事项

使用 Authorization: Bearer <CCAPI token> 鉴权

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

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

请求参数

Authorization

Body 参数application/json

示例

{
    "clip_id": "91b18142-1a37-4cb6-828a-89ceba4a8345",
    "name": "My Singer",
    "describe": "Warm female vocals with a breathy quality"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.ccapi.ai//suno/submit/PERSONA' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clip_id": "91b18142-1a37-4cb6-828a-89ceba4a8345",
    "name": "My Singer",
    "describe": "Warm female vocals with a breathy quality"
}'

返回响应

🟢200成功

application/json

Task completed immediately

Body

示例

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

🟠400请求有误

🟠401未认证

🟠403权限不足

🔴500服务器内部错误

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

导出为 WAV

检测 BPM