添加人声

POST

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

Add vocals to an existing track by overlaying new vocal content.

CCAPI 任务流程

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

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

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

计费

参考价格： $0.08

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

失败任务自动退费

注意事项

使用以下方式鉴权： Authorization: Bearer <CCAPI token>

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

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

请求参数

Authorization

Body 参数application/json

示例

{
    "custom": true,
    "clip_id": "91b18142-1a37-4cb6-828a-89ceba4a8345",
    "mv": "chirp-v4-5-plus",
    "gpt_description_prompt": "Soft female vocals, breathy and emotional",
    "prompt": "[Verse]\nSoftly whispering into the night..."
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.ccapi.ai//suno/submit/ADD_VOCALS' \
--header 'Content-Type: application/json' \
--data-raw '{
    "custom": true,
    "clip_id": "91b18142-1a37-4cb6-828a-89ceba4a8345",
    "mv": "chirp-v4-5-plus",
    "gpt_description_prompt": "Soft female vocals, breathy and emotional",
    "prompt": "[Verse]\nSoftly whispering into the night..."
}'

返回响应

🟢200成功

application/json

Task submitted

Body

示例

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

🟠400请求有误

🟠401未认证

🟠403权限不足

🔴500服务器内部错误

修改于 2026-03-27 07:50:11

提取全部音轨

添加伴奏