Generate Music

POST

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

Generate music from a text description or custom lyrics.

CCAPI Task Workflow

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

Fetch -> GET /suno/fetch/{id} or POST /suno/fetch -> inspect data.status and data.data

Complete -> when data.status = "SUCCESS", data.data contains the normalized result payload

Billing

Reference price: $0.08

Actual deduction still follows the current CCAPI pricing, group ratio, and channel configuration

Failed tasks are auto-refunded

Notes

Authenticate with Authorization: Bearer <CCAPI token>

Submit endpoints always return the public task_xxx ID instead of exposing the upstream job ID

Fetch endpoints return the persisted CCAPI task record (TaskDto) with normalized data payload

In simple mode (custom=false), you can pass just prompt as the song description

请求参数

Authorization

Body 参数application/json

示例

Simple Mode (AI-generated lyrics)Custom Mode (user-provided lyrics)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

Simple Mode (AI-generated lyrics)Custom Mode (user-provided lyrics)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:06

Batch Fetch Tasks

Fetch Task Status