Skip to main content
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
custom_modelobjectNoRequired when mv is chirp-custom. Inline custom model definition — see Custom Model

​
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
chirp-customInline custom model trained from your own tracks (see Custom Model)

​
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"
    }
  }'

​
Custom Model

Set mv to chirp-custom and pass an inline custom_model object to generate music in the style of your own reference tracks. The custom model is ephemeral — it’s trained for the request and discarded once generation completes. Pass the same custom_model payload on every request you want to use that style.

​
custom_model fields

FieldTypeRequiredDescription
namestringYesModel name
audio_urlslist[string]Yes6–24 audio URLs to train on

​
Example - Custom Model

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-custom",
      "custom": true,
      "custom_model": {
        "name": "audio model v1",
        "audio_urls": [
          "https://example.com/track1.mp3",
          "https://example.com/track2.mp3",
          "https://example.com/track3.mp3",
          "https://example.com/track4.mp3",
          "https://example.com/track5.mp3",
          "https://example.com/track6.mp3"
        ]
      },
      "prompt": "[Verse 1]\nWalking down the street at night...",
      "tags": "pop, electronic, upbeat",
      "title": "Night Walk"
    }
  }'

​
Response

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