Suno Task API

Generate Music

Generate music from a text description or custom lyrics.

CCAPI Task Workflow

  1. Submit -> POST /suno/submit/MUSIC -> {"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
  • In simple mode (custom=false), you can pass just prompt as the song description
post/suno/submit/MUSIC

Request

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

Request body

audio_weightnumber

Balance between lyrics and audio. Range: 0-1.

auto_lyricsboolean

Auto-generate lyrics even in custom mode.

customboolean required

Required. false = simple mode (AI generates lyrics from description), true = custom mode (you provide lyrics, title, tags).

gpt_description_promptstring

Legacy alias for description mode. Usually you only need prompt.

instrumentalboolean

Generate instrumental music without vocals.

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

Model version. Use the short name (e.g. chirp-v4, chirp-v5). Default: chirp-v4-5-plus. Also accepts sonic-* aliases (e.g. sonic-v4-5 → chirp-v4-5).

negative_tagsstring

Tags to exclude from generation (e.g. "heavy metal, rap").

persona_idstring

ID of a custom voice persona (created via /persona endpoint).

promptstring

When custom=false, use prompt as the music description. When custom=true, use prompt as the custom lyrics.

style_weightnumber

How strongly to apply the style tags. Range: 0-1.

tagsstring

Music style tags, comma-separated (e.g. "pop, upbeat, guitar"). Max 200 characters.

titlestring

Song title (custom mode).

vocal_gender'Male' | 'Female'

Preferred vocal gender.

weirdness_constraintnumber

How creative/experimental the generation should be. Range: 0-1.

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.