Suno Task API

Generate Lyrics

Generate song lyrics from a text prompt.

CCAPI Task Workflow

  1. Submit -> POST /suno/submit/LYRICS -> {"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/LYRICS

Request

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

Request body

lyrics_model'classic' | 'remi'

Lyrics generation model.

promptstring required

Text description of the lyrics to generate.

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.