> ## 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.

# Music Generation

> Generate music with Suno AI

Generate complete songs using Suno AI with simple or custom mode. To sing with a voice you created via [Voice Creation](/models/audio/suno/voice), 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](/models/audio/suno/voice). 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](#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](#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

```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/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

```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/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

```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/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

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