Producer Task API

Generate Music

Generate music from a sound description and/or custom lyrics using FUZZ models.

CCAPI Task Workflow

  1. Submit -> POST /producer/submit/MUSIC -> {"code":"success","data":"task_xxx"}
  2. Fetch -> GET /producer/fetch/{id} or POST /producer/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/producer/submit/MUSIC

Request

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

Request body

cover_art_urlstring uri

URL of custom cover art image.

hook_urlstring uri

Webhook URL for async callback when the job completes.

instrumentalboolean

Generate instrumental music without vocals.

is_storageboolean

Whether to store the generated audio permanently.

lyrics_strengthnumber

How strongly lyrics influence the generation. Range: 0-1.

lyrics_textstring

Custom lyrics for the song. Use section markers like [Verse 1], [Chorus], etc.

mv'FUZZ-3-Demo' | 'FUZZ-2.0 Pro' | 'FUZZ-2.0' | 'FUZZ-2.0 Raw' | 'FUZZ-1.1 Pro' | 'FUZZ-1.0 Pro' | 'FUZZ-1.0' | 'FUZZ-1.1' | 'FUZZ-0.8' | 'Lyria 3 preview'

Model version. Use the model name (e.g. FUZZ-2.0, FUZZ-2.0 Pro, Lyria 3 preview).

seedstring

Seed value for reproducible generation.

sound_promptstring

Text description of the desired music style, instruments, mood, tempo, etc.

sound_strengthnumber

How strongly the sound prompt influences the generation. Range: 0.2-1.

titlestring

Song title.

weirdnessnumber

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.