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
`nsfw_check`	boolean	No	Check uploaded media inputs for NSFW content. Default: `true`

Model Versions

Version	Description
`chirp-hawk`	Version 6 — powerful, versatile, refined. The default choice
`chirp-hawk-wild`	Version 6 Wild — the same model tuned for experimental, unpredictable output
`chirp-goose`	Version 6 Mini — faster and lighter than v6
`chirp-custom`	Inline custom model trained from your own tracks (see Custom Model)

Suno retired every model before v6. The old ids — chirp-v3-0, chirp-v3-5, chirp-v4, chirp-auk, chirp-auk-turbo, chirp-bluejay, chirp-crow, chirp-fenix — are still accepted so existing integrations keep working, and each one now generates on chirp-hawk.

Model Limits

Version	Prompt Limit	Style Limit
v6, v6 Wild, v6 Mini	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-hawk",
      "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-hawk",
      "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"
  }
}

Volume discounts are available for almost all models. Reach out at contact@unifically.com to discuss custom pricing.

​Model

​Parameters

​Model Versions

​Model Limits

​Example - Simple Mode

​Example - Custom Mode

​Custom Model

​custom_model fields

​Example - Custom Model

​Response

Model

Parameters

Model Versions

Model Limits

Example - Simple Mode

Example - Custom Mode

Custom Model

`custom_model` fields

Example - Custom Model

Response