> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifically.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mashup, Inspiration & Sample

> Create new songs from existing Suno clips: blend two songs, draw inspiration from up to four, or build around a sampled section. See parameters, pricing, and API examples.

Three ways to generate a new song from clips you already have. Each request returns a pair of new clips, like [Music Generation](/models/audio/suno/music).

## 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](/models/audio/suno/music#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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```json theme={null}
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}
```

<Note>
  **Volume discounts** are available for almost all models. Reach out at [contact@unifically.com](mailto:contact@unifically.com) to discuss custom pricing.
</Note>