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. Try it in the browser: Suno API playground.

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

Result

Poll GET /v1/tasks/{task_id}. A completed task returns both generated songs. Each clip’s id is the clip_id that Extend, Cover, Stems, Remaster, Editing and the other clip operations take. audio_url1 and audio_url2 repeat the first two clips’ audio for quick access.

{
  "task_id": "abc123def456",
  "status": "completed",
  "audio_url1": "https://files.unifically.com/audio/….mp3",
  "audio_url2": "https://files.unifically.com/audio/….mp3",
  "clips": [
    {
      "id": "1901ec96-72c6-4c26-8e56-91028ca6070d",
      "status": "complete",
      "title": "Night Walk",
      "audio_url": "https://files.unifically.com/audio/….mp3",
      "image_url": "https://….jpeg",
      "image_large_url": "https://….jpeg",
      "video_url": "https://….mp4",
      "duration": 182.4,
      "prompt": "[Verse 1]
Walking down the street at night...",
      "model_name": "chirp-hawk",
      "created_at": "2026-10-13T09:15:02.000Z"
    }
  ]
}

Operations that return several tracks, such as suno-ai/stems-all, list every track in clips.

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

​Result

Model

Parameters

Model Versions

Model Limits

Example - Simple Mode

Example - Custom Mode

Custom Model

`custom_model` fields

Example - Custom Model

Response

Result