Mashup, Inspiration & Sample - Unifically

Three ways to generate a new song from clips you already have. Each request returns a pair of new clips, like Music Generation.

Models

Model	What it does
`suno-ai/mashup`	Blends exactly two clips into one new song
`suno-ai/inspiration`	Generates a new song guided by one to four reference clips
`suno-ai/sample`	Builds a new song around a sampled window of one clip

Shared parameters

Parameter	Type	Required	Description
`mv`	string	Yes	Model version, see Model Versions
`tags`	string	No	Genre/style tags
`prompt`	string	No	Custom lyrics
`title`	string	No	Song title
`make_instrumental`	boolean	No	Generate instrumental only
`negative_tags`	string	No	Styles to avoid

Model-specific parameters

Model	Parameter	Type	Required	Description
`suno-ai/mashup`	`clip_ids`	string[]	Yes	Exactly 2 clip IDs
`suno-ai/inspiration`	`clip_ids`	string[]	Yes	1 to 4 clip IDs
`suno-ai/sample`	`clip_id`	string	Yes	Clip to sample from
`suno-ai/sample`	`start_s`	number	No	Sample window start in seconds. Default: `0`
`suno-ai/sample`	`end_s`	number	No	Sample window end in seconds. Default: `60`

Example - Mashup

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/mashup",
    "input": {
      "mv": "chirp-fenix",
      "clip_ids": [
        "1901ec96-72c6-4c26-8e56-91028ca6070d",
        "5a6bb955-1536-4f43-877a-b4aa9fb18a4e"
      ],
      "tags": "lofi piano, late night"
    }
  }'

Example - Inspiration

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/inspiration",
    "input": {
      "mv": "chirp-fenix",
      "clip_ids": ["1901ec96-72c6-4c26-8e56-91028ca6070d"],
      "tags": "rainy night, ambient",
      "make_instrumental": true
    }
  }'

Example - Sample

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/sample",
    "input": {
      "mv": "chirp-fenix",
      "clip_id": "1901ec96-72c6-4c26-8e56-91028ca6070d",
      "start_s": 0,
      "end_s": 30,
      "tags": "boom bap, vinyl"
    }
  }'

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.