Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.unifically.com/llms.txt

Use this file to discover all available pages before exploring further.

Generate complete songs using Suno AI with simple or custom mode. To sing with a voice you created via Voice Creation, pass its persona_id in the request input.

​
Model

suno-ai/music

​
Parameters

ParameterTypeRequiredDescription
mvstringYesModel version (see below)
custombooleanYesfalse for simple mode, true for custom mode
gpt_description_promptstringNoSimple mode: song description with lyrics
promptstringNoCustom mode: detailed lyrics/prompt
tagsstringNoCustom mode: genre/style tags
titlestringNoSong title
make_instrumentalbooleanNoGenerate instrumental only
negative_tagsstringNoCustom mode: styles to avoid
persona_idstringNoID of a custom voice from Voice Creation. When set, the generated music uses that voice for vocals

​
Model Versions

VersionDescription
chirp-v3-5Version 3.5
chirp-v4Version 4.0
chirp-aukVersion 4.5
chirp-bluejayVersion 4.5+
chirp-crowVersion 5.0
chirp-fenixVersion 5.5

​
Model Limits

VersionPrompt LimitStyle Limit
v3.5, v43,000 chars200 chars
v4.5, v4.5+, v5, v5.55,000 chars1,000 chars
Simple Mode500 chars-

​
Example - Simple Mode

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/music",
    "input": {
      "mv": "chirp-bluejay",
      "custom": false,
      "gpt_description_prompt": "[Verse 1]\nHello world\n[Chorus]\nThis is my song",
      "make_instrumental": false,
      "title": "My First Song"
    }
  }'

​
Example - Custom Mode

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/music",
    "input": {
      "mv": "chirp-bluejay",
      "custom": true,
      "prompt": "[Verse 1]\nWalking down the street at night...",
      "tags": "pop, electronic, upbeat",
      "title": "Night Walk",
      "negative_tags": "metal, jazz"
    }
  }'

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}