Suno Task API

Create Cover

Create a cover version of a song with a new style.

CCAPI Task Workflow

  1. Submit -> POST /suno/submit/COVER -> {"code":"success","data":"task_xxx"}
  2. Fetch -> GET /suno/fetch/{id} or POST /suno/fetch -> inspect data.status and data.data
  3. Complete -> when data.status = "SUCCESS", data.data contains the normalized result payload

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
post/suno/submit/COVER

Request

  • Base URL: https://api.ccapi.ai
  • URL: https://api.ccapi.ai/suno/submit/COVER
  • Auth: HTTP bearer

Request body

audio_weightnumber
clip_idstring required

ID of the song to cover.

customboolean required

false = AI-generated style, true = custom style.

gpt_description_promptstring

Style description (simple mode).

mv'chirp-v4-5-all' | 'chirp-v3-5' | 'chirp-v4' | 'chirp-v4-5' | 'chirp-v4-5-plus' | 'chirp-v5' required

Model version. Also accepts sonic-* aliases (e.g. sonic-v4-5 → chirp-v4-5).

negative_tagsstring
persona_idstring
promptstring

Custom lyrics (custom mode).

style_weightnumber
tagsstring
titlestring
vocal_gender'Male' | 'Female'
weirdness_constraintnumber

Response

Task submitted

codestring required
datastring required

Public CCAPI task ID. Use this value to poll task status.

messagestring

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.