Music Generation - Unifically

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

Parameter	Type	Required	Description
`mv`	string	Yes	Model version (see below)
`custom`	boolean	Yes	`false` for simple mode, `true` for custom mode
`gpt_description_prompt`	string	No	Simple mode: song description with lyrics
`prompt`	string	No	Custom mode: detailed lyrics/prompt
`tags`	string	No	Custom mode: genre/style tags
`title`	string	No	Song title
`make_instrumental`	boolean	No	Generate instrumental only
`negative_tags`	string	No	Custom mode: styles to avoid
`persona_id`	string	No	ID of a custom voice from Voice Creation. When set, the generated music uses that voice for vocals
`custom_model`	object	No	Required when `mv` is `chirp-custom`. Inline custom model definition — see Custom Model

Model Versions

Version	Description
`chirp-v3-5`	Version 3.5
`chirp-v4`	Version 4.0
`chirp-auk`	Version 4.5
`chirp-bluejay`	Version 4.5+
`chirp-crow`	Version 5.0
`chirp-fenix`	Version 5.5
`chirp-custom`	Inline custom model trained from your own tracks (see Custom Model)

Model Limits

Version	Prompt Limit	Style Limit
v3.5, v4	3,000 chars	200 chars
v4.5, v4.5+, v5, v5.5	5,000 chars	1,000 chars
Simple Mode	500 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

Field	Type	Required	Description
`name`	string	Yes	Model name
`audio_urls`	list[string]	Yes	6–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": "processing"
  }
}

​Model

​Parameters

​Model Versions

​Model Limits

​Example - Simple Mode

​Example - Custom Mode

​Custom Model

​custom_model fields

​Example - Custom Model

​Response