# Suno V6 API

> Suno V6 songs and sounds from scratch by a description or your own lyrics: two MP3 variants of the track per run. From your audio: add vocals or music, a cover, a continuation, a rewritten part, a mashup of two tracks. Versions V6 Mini and V6 Wild are available too.

Developer: Suno
Model key in the API: `suno`

## Connect in three steps

1. [Get a key](https://api.cyhub.ai/docs/connection.md?lang=en): Create a key in the dashboard after you confirm your email. One key opens every model.
2. [Check the price](https://api.cyhub.ai/docs/generations.md?lang=en): POST /v1/price shows the cost of a run in advance, without charging you.
3. [Run a task and collect the result](https://api.cyhub.ai/docs/tasks.md?lang=en): POST /v1/tasks starts a task, GET /v1/tasks/{id} shows its status and files.

## Ready-to-use code

Replace YOUR_API_KEY with your key. The code starts a task and waits for the result. In cURL, repeat the second request with the id from the first response instead of TASK_ID until status becomes succeeded.

```bash
curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "suno",
  "settings": {
    "mode": "generate",
    "model": "V6",
    "customMode": false,
    "songDescription": "Лёгкая летняя песня о дороге к морю, акустическая гитара, женский вокал"
  }
}'

curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```python
import time

import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

body = {
    "model": "suno",
    "settings": {
        "mode": "generate",
        "model": "V6",
        "customMode": False,
        "songDescription": "Лёгкая летняя песня о дороге к морю, акустическая гитара, женский вокал",
    },
}

response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
    time.sleep(5)
    task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])
```

```javascript
const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const body = {
  "model": "suno",
  "settings": {
    "mode": "generate",
    "model": "V6",
    "customMode": false,
    "songDescription": "Лёгкая летняя песня о дороге к морю, акустическая гитара, женский вокал"
  }
};

async function main() {
  let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
  if (!response.ok) throw new Error(await response.text());
  let task = await response.json();
  while (task.status === "queued" || task.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
    task = await response.json();
  }
  console.log(task.status, task.result);
}

main();
```

[Get a key](https://cyhub.ai/cabinet/keys)

## Price before the run

Prices as of 15.10.2026: from 3 ₽. POST /v1/price shows the exact price of your settings.

Send the same settings to POST /v1/price: the response shows the price of the run without charging you.

```bash
curl -X POST "https://api.cyhub.ai/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "suno",
  "settings": {
    "mode": "generate",
    "model": "V6",
    "customMode": false,
    "songDescription": "Лёгкая летняя песня о дороге к морю, акустическая гитара, женский вокал"
  }
}'
```

- amount_minor: the price of the run in minor units (kopecks for rubles)
- currency: the wallet currency
- available_minor: how much your balance has for new tasks right now

## <a id="generate"></a>A song from scratch

> A song from a short description, or with your own lyrics, style and title.

Value of the mode field: `generate`

Price in this mode from 12 ₽.

### Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

#### `model` (Optional)

Model version.

- Type: String
- Allowed values: `V6`, `V6_MINI` (V6 Mini), `V6_WILD` (V6 Wild)
- Default: `"V6"`

#### `customMode` (Optional)

Advanced mode: your own lyrics, style, title and duration. Off: a song description is enough.

- Type: Boolean
- Default: `false`

#### `songDescription` (Optional)

Song description for the simple mode: subject, mood, genre. Required when customMode is off.

- Type: String
- Maximum characters: 3000

#### `title` (Optional)

Song title. Required in advanced mode, not set in simple mode.

- Type: String
- Maximum characters: 80

#### `style` (Optional)

Style and genre in words. Required in advanced mode, not set in simple mode.

- Type: String
- Maximum characters: 1000

#### `prompt` (Optional)

Lyrics for the advanced mode. Required unless the track is instrumental. Not set in simple mode: there the description defines the song.

- Type: String
- Maximum characters: 5000

#### `instrumental` (Optional)

No vocals.

- Type: Boolean
- Default: `false`

#### `vocalGender` (Optional)

Singer voice, advanced mode only.

- Type: String
- Allowed values: `m`, `f`
- Default: `"m"`

#### `duration` (Optional)

Duration in seconds, advanced mode only.

- Type: Integer
- Minimum: 10
- Maximum: 360
- Default: `20`

#### `styleWeight` (Optional)

How strictly to follow the given style: 0 loosely, 1 strictly, at most two decimals. Advanced mode only.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `weirdnessConstraint` (Optional)

How bold the result is: 0 predictable, 1 experimental, at most two decimals. Advanced mode only.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `audioWeight` (Optional)

Weight of the audio features in the result: 0 weak, 1 strong, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

Parameters not listed here are not accepted: the response is 422 unknown_setting.

### Input

- Simple mode: a song description, the model invents the rest. Title, style and lyrics are not set in it.
- Advanced mode: title and style are required; lyrics are required unless the track is instrumental.
- Voice, duration, style weight and weirdness work only in advanced mode: in simple mode they are not sent.

### Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

Song from a description

```json
{
  "model": "suno",
  "settings": {
    "mode": "generate",
    "model": "V6",
    "customMode": false,
    "songDescription": "Лёгкая летняя песня о дороге к морю, акустическая гитара, женский вокал"
  }
}
```

Song with your own lyrics

```json
{
  "model": "suno",
  "settings": {
    "mode": "generate",
    "model": "V6",
    "customMode": true,
    "title": "Дорога к морю",
    "style": "акустический поп, лето",
    "prompt": "Куплет 1: ...\nПрипев: ...",
    "instrumental": false,
    "vocalGender": "f",
    "duration": 120
  }
}
```

The price is calculated when the task is accepted, currency `RUB`.

[Complete generation example](https://api.cyhub.ai/docs/generations.md?lang=en)

### Output

- Two MP3 versions of the track per run, plus the title and lyrics as text when there are any.
- A song takes 5 to 10 minutes, a sound about a minute.

| Kind | Formats | How many | Note |
|---|---|---|---|
| `audio` | mp3 | 2 | Two versions of the track. |

`result.texts`: The title and lyrics of the song, when there are any.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [
      "Text of the result, for example lyrics"
    ],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[How to read the result and download files](https://api.cyhub.ai/docs/tasks.md?lang=en#result)

## <a id="sounds"></a>A sound or ambience

> Not a song but a sound: rain, city hum, a game effect. It can be looped, with a set tempo and key.

Value of the mode field: `sounds`

Price in this mode from 3 ₽.

### Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

#### `model` (Optional)

Model version.

- Type: String
- Allowed values: `V6`, `V6_MINI` (V6 Mini), `V6_WILD` (V6 Wild)
- Default: `"V6"`

#### `soundDescription` (Required)

What it should sound like, for example rain on a roof or footsteps in snow. There will be no lyrics.

- Type: String
- Minimum characters: 1
- Maximum characters: 500

#### `soundLoop` (Optional)

Make the end flow into the beginning without a click: for background that plays in a loop.

- Type: Boolean
- Default: `false`

#### `soundTempo` (Optional)

Tempo in beats per minute. Not set: the model chooses it.

- Type: Integer
- Minimum: 1
- Maximum: 300

#### `soundKey` (Optional)

Key: a letter means major, a letter with m means minor (Am is A minor). An empty string: any.

- Type: String
- Allowed values: `""` (Any), `C`, `C#`, `D`, `D#`, `E`, `F`, `F#`, `G`, `G#`, `A`, `A#`, `B`, `Cm`, `C#m`, `Dm`, `D#m`, `Em`, `Fm`, `F#m`, `Gm`, `G#m`, `Am`, `A#m`, `Bm`
- Default: `""`

Parameters not listed here are not accepted: the response is 422 unknown_setting.

### Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

Background for a video

```json
{
  "model": "suno",
  "settings": {
    "mode": "sounds",
    "soundDescription": "Шум дождя по жестяной крыше, далёкие раскаты грома",
    "soundLoop": true
  }
}
```

The price is calculated when the task is accepted, currency `RUB`.

[Complete generation example](https://api.cyhub.ai/docs/generations.md?lang=en)

### Output

- Two MP3 versions of the track per run, plus the title and lyrics as text when there are any.
- A song takes 5 to 10 minutes, a sound about a minute.

| Kind | Formats | How many | Note |
|---|---|---|---|
| `audio` | mp3 | 2 | Two versions of the track. |

`result.texts`: The title and lyrics of the song, when there are any.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [
      "Text of the result, for example lyrics"
    ],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[How to read the result and download files](https://api.cyhub.ai/docs/tasks.md?lang=en#result)

## <a id="add_vocals"></a>Add vocals

> Vocals on top of your music without a voice: the model sings your lyrics in the given style.

Value of the mode field: `add_vocals`

Price in this mode from 12 ₽, with a 1 s file.

### Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

#### `model` (Optional)

Model version.

- Type: String
- Allowed values: `V6`, `V6_MINI` (V6 Mini), `V6_WILD` (V6 Wild)
- Default: `"V6"`

#### `audio` (Required)

One URL of your music without vocals.

- Type: List (String, uri)
- Maximum items: 1

#### `title` (Required)

Track title. Required.

- Type: String
- Minimum characters: 1
- Maximum characters: 80

#### `style` (Required)

Style and genre in words. Required.

- Type: String
- Minimum characters: 1
- Maximum characters: 1000

#### `prompt` (Required)

The lyrics the vocals will sing.

- Type: String
- Minimum characters: 1
- Maximum characters: 5000

#### `negativeTags` (Required)

Styles that must not appear in the result, comma separated. Required.

- Type: String
- Minimum characters: 1
- Maximum characters: 500

#### `vocalGender` (Optional)

Singer gender: m male, f female. Only raises the chance, does not guarantee it. Not set: the model decides.

- Type: String
- Allowed values: `""` (Not set), `m`, `f`
- Default: `""`

#### `styleWeight` (Optional)

How strictly to follow the given style: 0 loosely, 1 strictly, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `weirdnessConstraint` (Optional)

How bold the result is: 0 predictable, 1 experimental, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `audioWeight` (Optional)

How closely the result keeps the sound of the source: 0 loosely, 1 closely, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

Parameters not listed here are not accepted: the response is 422 unknown_setting.

### Input

- Audio is a URL of an MP3, WAV, OGG, M4A, FLAC or AAC file up to 20 MB.
- Your own audio only: Suno recognises well-known songs by others and refuses them.

| Field | Accepts | Formats | Files | File size up to |
|---|---|---|---|---|
| `audio` | Audio | mp3, wav, ogg, m4a, flac, aac | 1 | 20 MB |

[How to send files](https://api.cyhub.ai/docs/files.md?lang=en)

### Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

Vocals on your music

```json
{
  "model": "suno",
  "settings": {
    "mode": "add_vocals",
    "audio": [
      "https://example.com/my-instrumental.mp3"
    ],
    "title": "Ночной город",
    "style": "синти-поп, мягкий женский вокал",
    "prompt": "Куплет 1: ...\nПрипев: ...",
    "negativeTags": "хеви-метал, рэп"
  }
}
```

The price is calculated when the task is accepted, currency `RUB`.

[Complete generation example](https://api.cyhub.ai/docs/generations.md?lang=en)

### Output

- Two MP3 versions of the track per run, plus the title and lyrics as text when there are any.
- A song takes 5 to 10 minutes, a sound about a minute.

| Kind | Formats | How many | Note |
|---|---|---|---|
| `audio` | mp3 | 2 | Two versions of the track. |

`result.texts`: The title and lyrics of the song, when there are any.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [
      "Text of the result, for example lyrics"
    ],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[How to read the result and download files](https://api.cyhub.ai/docs/tasks.md?lang=en#result)

## <a id="add_instrumental"></a>Add instrumental

> Music under your vocals recorded without accompaniment.

Value of the mode field: `add_instrumental`

Price in this mode from 12 ₽, with a 1 s file.

### Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

#### `model` (Optional)

Model version.

- Type: String
- Allowed values: `V6`, `V6_MINI` (V6 Mini), `V6_WILD` (V6 Wild)
- Default: `"V6"`

#### `audio` (Required)

One URL of your vocals without music.

- Type: List (String, uri)
- Maximum items: 1

#### `title` (Required)

Track title. Required.

- Type: String
- Minimum characters: 1
- Maximum characters: 80

#### `tags` (Required)

Music style in words: genre, instruments, mood. Required.

- Type: String
- Minimum characters: 1
- Maximum characters: 500

#### `negativeTags` (Required)

Styles that must not appear in the result, comma separated. Required.

- Type: String
- Minimum characters: 1
- Maximum characters: 500

#### `vocalGender` (Optional)

Singer gender: m male, f female. Only raises the chance, does not guarantee it. Not set: the model decides.

- Type: String
- Allowed values: `""` (Not set), `m`, `f`
- Default: `""`

#### `styleWeight` (Optional)

How strictly to follow the given style: 0 loosely, 1 strictly, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `weirdnessConstraint` (Optional)

How bold the result is: 0 predictable, 1 experimental, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `audioWeight` (Optional)

How closely the result keeps the sound of the source: 0 loosely, 1 closely, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

Parameters not listed here are not accepted: the response is 422 unknown_setting.

### Input

- Audio is a URL of an MP3, WAV, OGG, M4A, FLAC or AAC file up to 20 MB.
- Your own audio only: Suno recognises well-known songs by others and refuses them.

| Field | Accepts | Formats | Files | File size up to |
|---|---|---|---|---|
| `audio` | Audio | mp3, wav, ogg, m4a, flac, aac | 1 | 20 MB |

[How to send files](https://api.cyhub.ai/docs/files.md?lang=en)

### Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

Music under your voice

```json
{
  "model": "suno",
  "settings": {
    "mode": "add_instrumental",
    "audio": [
      "https://example.com/my-vocals.mp3"
    ],
    "title": "Колыбельная",
    "tags": "нежное фортепиано, струнные",
    "negativeTags": "барабаны, электроника"
  }
}
```

The price is calculated when the task is accepted, currency `RUB`.

[Complete generation example](https://api.cyhub.ai/docs/generations.md?lang=en)

### Output

- Two MP3 versions of the track per run, plus the title and lyrics as text when there are any.
- A song takes 5 to 10 minutes, a sound about a minute.

| Kind | Formats | How many | Note |
|---|---|---|---|
| `audio` | mp3 | 2 | Two versions of the track. |

`result.texts`: The title and lyrics of the song, when there are any.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [
      "Text of the result, for example lyrics"
    ],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[How to read the result and download files](https://api.cyhub.ai/docs/tasks.md?lang=en#result)

## <a id="cover_upload"></a>A cover of your audio

> The melody of your track stays, the style changes. As with a song from scratch: from a description or with your own lyrics, style and title.

Value of the mode field: `cover_upload`

Price in this mode from 12 ₽, with a 1 s file.

### Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

#### `model` (Optional)

Model version.

- Type: String
- Allowed values: `V6`, `V6_MINI` (V6 Mini), `V6_WILD` (V6 Wild)
- Default: `"V6"`

#### `audio` (Required)

One URL of your track.

- Type: List (String, uri)
- Maximum items: 1

#### `customMode` (Optional)

Advanced mode: your own lyrics, style, title and duration. Off: a song description is enough.

- Type: Boolean
- Default: `false`

#### `songDescription` (Optional)

Song description for the simple mode: subject, mood, genre. Required when customMode is off.

- Type: String
- Maximum characters: 3000

#### `title` (Optional)

Song title. Required in advanced mode, not set in simple mode.

- Type: String
- Maximum characters: 80

#### `style` (Optional)

Style and genre in words. Required in advanced mode, not set in simple mode.

- Type: String
- Maximum characters: 1000

#### `prompt` (Optional)

Lyrics for the advanced mode. Required unless the track is instrumental. Not set in simple mode: there the description defines the song.

- Type: String
- Maximum characters: 5000

#### `instrumental` (Optional)

No vocals.

- Type: Boolean
- Default: `false`

#### `negativeTags` (Optional)

Styles that must not appear in the result, comma separated. Advanced mode only.

- Type: String
- Maximum characters: 500

#### `duration` (Optional)

Duration in seconds, advanced mode only.

- Type: Integer
- Minimum: 10
- Maximum: 360
- Default: `20`

#### `styleWeight` (Optional)

How strictly to follow the given style: 0 loosely, 1 strictly, at most two decimals. Advanced mode only.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `weirdnessConstraint` (Optional)

How bold the result is: 0 predictable, 1 experimental, at most two decimals. Advanced mode only.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `audioWeight` (Optional)

How closely the result keeps the sound of the source: 0 loosely, 1 closely, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

Parameters not listed here are not accepted: the response is 422 unknown_setting.

### Input

- Audio is a URL of an MP3, WAV, OGG, M4A, FLAC or AAC file up to 20 MB.
- Your own audio only: Suno recognises well-known songs by others and refuses them.
- The track is at most 8 minutes long.
- Simple mode: a song description, the model invents the rest. Title, style and lyrics are not set in it.
- Advanced mode: title and style are required; lyrics are required unless the track is instrumental.
- Duration, style weight and weirdness work only in advanced mode: in simple mode they are not sent.

| Field | Accepts | Formats | Files | File size up to |
|---|---|---|---|---|
| `audio` | Audio | mp3, wav, ogg, m4a, flac, aac | 1 | 20 MB |

[How to send files](https://api.cyhub.ai/docs/files.md?lang=en)

### Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

A cover in another style

```json
{
  "model": "suno",
  "settings": {
    "mode": "cover_upload",
    "audio": [
      "https://example.com/my-song.mp3"
    ],
    "customMode": false,
    "songDescription": "Та же мелодия в стиле лёгкого джаза, женский вокал"
  }
}
```

The price is calculated when the task is accepted, currency `RUB`.

[Complete generation example](https://api.cyhub.ai/docs/generations.md?lang=en)

### Output

- Two MP3 versions of the track per run, plus the title and lyrics as text when there are any.
- A song takes 5 to 10 minutes, a sound about a minute.

| Kind | Formats | How many | Note |
|---|---|---|---|
| `audio` | mp3 | 2 | Two versions of the track. |

`result.texts`: The title and lyrics of the song, when there are any.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [
      "Text of the result, for example lyrics"
    ],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[How to read the result and download files](https://api.cyhub.ai/docs/tasks.md?lang=en#result)

## <a id="extend"></a>Continue your audio

> The track continues from the chosen second. The continuation second is required, the style and title are optional: without them the continuation follows the track itself.

Value of the mode field: `extend`

Price in this mode from 12 ₽, with a 90 s file.

### Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

#### `model` (Optional)

Model version.

- Type: String
- Allowed values: `V6`, `V6_MINI` (V6 Mini), `V6_WILD` (V6 Wild)
- Default: `"V6"`

#### `audio` (Required)

One URL of your track.

- Type: List (String, uri)
- Maximum items: 1

#### `title` (Optional)

Track title. Optional.

- Type: String
- Maximum characters: 100

#### `style` (Optional)

Style and genre in words. Optional.

- Type: String
- Maximum characters: 1000

#### `prompt` (Optional)

Lyrics of the continuation. Required unless the continuation is instrumental.

- Type: String
- Maximum characters: 5000

#### `instrumental` (Optional)

A continuation without vocals.

- Type: Boolean
- Default: `false`

#### `continueAt` (Required)

The second of the track where the continuation starts. Before the end of the file.

- Type: Number
- Minimum: 1
- Maximum: 480

#### `negativeTags` (Optional)

Styles that must not appear in the result, comma separated.

- Type: String
- Maximum characters: 500

#### `vocalGender` (Optional)

Singer gender: m male, f female. Only raises the chance, does not guarantee it. Not set: the model decides.

- Type: String
- Allowed values: `""` (Not set), `m`, `f`
- Default: `""`

#### `styleWeight` (Optional)

How strictly to follow the given style: 0 loosely, 1 strictly, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `weirdnessConstraint` (Optional)

How bold the result is: 0 predictable, 1 experimental, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `audioWeight` (Optional)

How closely the result keeps the sound of the source: 0 loosely, 1 closely, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

Parameters not listed here are not accepted: the response is 422 unknown_setting.

> The API sets these settings itself, do not send them: `defaultParamFlag` = `true`

### Input

- Audio is a URL of an MP3, WAV, OGG, M4A, FLAC or AAC file up to 20 MB.
- Your own audio only: Suno recognises well-known songs by others and refuses them.
- The track is at most 8 minutes long.
- The continuation second comes before the end of the track.

| Field | Accepts | Formats | Files | File size up to |
|---|---|---|---|---|
| `audio` | Audio | mp3, wav, ogg, m4a, flac, aac | 1 | 20 MB |

[How to send files](https://api.cyhub.ai/docs/files.md?lang=en)

### Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

Continue your track

```json
{
  "model": "suno",
  "settings": {
    "mode": "extend",
    "audio": [
      "https://example.com/my-song.mp3"
    ],
    "title": "Дорога к морю",
    "style": "акустический поп, лето",
    "prompt": "Куплет 3: ...\nПрипев: ...",
    "continueAt": 60
  }
}
```

Continue without lyrics, as the track sounds

```json
{
  "model": "suno",
  "settings": {
    "mode": "extend",
    "audio": [
      "https://example.com/my-song.mp3"
    ],
    "instrumental": true,
    "continueAt": 90
  }
}
```

The price is calculated when the task is accepted, currency `RUB`.

[Complete generation example](https://api.cyhub.ai/docs/generations.md?lang=en)

### Output

- Two MP3 versions of the track per run, plus the title and lyrics as text when there are any.
- A song takes 5 to 10 minutes, a sound about a minute.

| Kind | Formats | How many | Note |
|---|---|---|---|
| `audio` | mp3 | 2 | Two versions of the track. |

`result.texts`: The title and lyrics of the song, when there are any.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [
      "Text of the result, for example lyrics"
    ],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[How to read the result and download files](https://api.cyhub.ai/docs/tasks.md?lang=en#result)

## <a id="replace_upload"></a>Rewrite a part of your audio

> Only the chosen section of the track is rewritten, the rest stays and is stitched to the new part.

Value of the mode field: `replace_upload`

Price in this mode from 5 ₽, with a 60 s file.

### Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

#### `model` (Optional)

Model version.

- Type: String
- Allowed values: `V6`, `V6_MINI` (V6 Mini), `V6_WILD` (V6 Wild)
- Default: `"V6"`

#### `audio` (Required)

One URL of your track.

- Type: List (String, uri)
- Maximum items: 1

#### `infillStartS` (Required)

Start of the section in seconds, at most two decimals, for example 45.25.

- Type: Number
- Minimum: 0

#### `infillEndS` (Required)

End of the section in seconds, at most two decimals. At least 10 seconds and at most half of the track.

- Type: Number
- Minimum: 0

#### `prompt` (Required)

New lyrics for this section.

- Type: String
- Minimum characters: 1
- Maximum characters: 5000

#### `fullLyrics` (Required)

The whole lyrics, already with the changed section. If there are no lyrics, describe in order what sounds.

- Type: String
- Minimum characters: 1
- Maximum characters: 5000

#### `tags` (Required)

Style of the new section in words. Required.

- Type: String
- Minimum characters: 1
- Maximum characters: 500

#### `title` (Required)

Track title. Required.

- Type: String
- Minimum characters: 1
- Maximum characters: 80

#### `negativeTags` (Optional)

Styles that must not appear in the result, comma separated.

- Type: String
- Maximum characters: 500

Parameters not listed here are not accepted: the response is 422 unknown_setting.

### Input

- Audio is a URL of an MP3, WAV, OGG, M4A, FLAC or AAC file up to 20 MB.
- Your own audio only: Suno recognises well-known songs by others and refuses them.
- The section is at least 10 seconds and at most half of the track.

| Field | Accepts | Formats | Files | File size up to |
|---|---|---|---|---|
| `audio` | Audio | mp3, wav, ogg, m4a, flac, aac | 1 | 20 MB |

[How to send files](https://api.cyhub.ai/docs/files.md?lang=en)

### Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

A new chorus

```json
{
  "model": "suno",
  "settings": {
    "mode": "replace_upload",
    "audio": [
      "https://example.com/my-song.mp3"
    ],
    "infillStartS": 45,
    "infillEndS": 70,
    "prompt": "Новый припев: ...",
    "fullLyrics": "Куплет 1: ...\nНовый припев: ...\nКуплет 2: ...",
    "tags": "поп-рок, энергично",
    "title": "Дорога к морю"
  }
}
```

The price is calculated when the task is accepted, currency `RUB`.

[Complete generation example](https://api.cyhub.ai/docs/generations.md?lang=en)

### Output

- Two MP3 versions of the track per run, plus the title and lyrics as text when there are any.
- A song takes 5 to 10 minutes, a sound about a minute.

| Kind | Formats | How many | Note |
|---|---|---|---|
| `audio` | mp3 | 2 | Two versions of the track. |

`result.texts`: The title and lyrics of the song, when there are any.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [
      "Text of the result, for example lyrics"
    ],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[How to read the result and download files](https://api.cyhub.ai/docs/tasks.md?lang=en#result)

## <a id="mashup"></a>A mashup of two tracks

> Two of your tracks are mixed into one, the first sets the base. From a description or with your own lyrics, style and title.

Value of the mode field: `mashup`

Price in this mode from 12 ₽, with a 1 s file.

### Parameters

Model parameters go inside settings. Omitted optional fields take their default values.

#### `model` (Optional)

Model version.

- Type: String
- Allowed values: `V6`, `V6_MINI` (V6 Mini), `V6_WILD` (V6 Wild)
- Default: `"V6"`

#### `audio` (Required)

URL of the first track: it sets the base.

- Type: List (String, uri)
- Maximum items: 1

#### `audio2` (Required)

URL of the second track.

- Type: List (String, uri)
- Maximum items: 1

#### `customMode` (Optional)

Advanced mode: your own lyrics, style, title and duration. Off: a song description is enough.

- Type: Boolean
- Default: `false`

#### `songDescription` (Optional)

Song description for the simple mode: subject, mood, genre. Required when customMode is off.

- Type: String
- Maximum characters: 3000

#### `title` (Optional)

Song title. Required in advanced mode, not set in simple mode.

- Type: String
- Maximum characters: 80

#### `style` (Optional)

Style and genre in words. Required in advanced mode, not set in simple mode.

- Type: String
- Maximum characters: 1000

#### `prompt` (Optional)

Lyrics for the advanced mode, optional. Not set in simple mode: there the description defines the song.

- Type: String
- Maximum characters: 5000

#### `instrumental` (Optional)

No vocals.

- Type: Boolean
- Default: `false`

#### `duration` (Optional)

Duration in seconds, advanced mode only.

- Type: Integer
- Minimum: 10
- Maximum: 360
- Default: `20`

#### `styleWeight` (Optional)

How strictly to follow the given style: 0 loosely, 1 strictly, at most two decimals. Advanced mode only.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `weirdnessConstraint` (Optional)

How bold the result is: 0 predictable, 1 experimental, at most two decimals. Advanced mode only.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

#### `audioWeight` (Optional)

How closely the result keeps the sound of the source: 0 loosely, 1 closely, at most two decimals.

- Type: Number
- Minimum: 0.0
- Maximum: 1.0
- Default: `0.65`

Parameters not listed here are not accepted: the response is 422 unknown_setting.

### Input

- Audio is a URL of an MP3, WAV, OGG, M4A, FLAC or AAC file up to 20 MB.
- Your own audio only: Suno recognises well-known songs by others and refuses them.
- Simple mode: a song description, the model invents the rest. Title, style and lyrics are not set in it.
- Advanced mode: title and style are required, lyrics are optional.
- Duration, style weight and weirdness work only in advanced mode: in simple mode they are not sent.

| Field | Accepts | Formats | Files | File size up to |
|---|---|---|---|---|
| `audio` | Audio | mp3, wav, ogg, m4a, flac, aac | 1 | 20 MB |
| `audio2` | Audio | mp3, wav, ogg, m4a, flac, aac | 1 | 20 MB |

[How to send files](https://api.cyhub.ai/docs/files.md?lang=en)

### Request example

Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.

A mashup from a description

```json
{
  "model": "suno",
  "settings": {
    "mode": "mashup",
    "audio": [
      "https://example.com/track-1.mp3"
    ],
    "audio2": [
      "https://example.com/track-2.mp3"
    ],
    "customMode": false,
    "songDescription": "Танцевальный ремикс, быстрый темп, яркий припев"
  }
}
```

The price is calculated when the task is accepted, currency `RUB`.

[Complete generation example](https://api.cyhub.ai/docs/generations.md?lang=en)

### Output

- Two MP3 versions of the track per run, plus the title and lyrics as text when there are any.
- A song takes 5 to 10 minutes, a sound about a minute.

| Kind | Formats | How many | Note |
|---|---|---|---|
| `audio` | mp3 | 2 | Two versions of the track. |

`result.texts`: The title and lyrics of the song, when there are any.

A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Caption of the result: the model and its settings",
    "texts": [
      "Text of the result, for example lyrics"
    ],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[How to read the result and download files](https://api.cyhub.ai/docs/tasks.md?lang=en#result)

## See also

- [Suno V6: features and prices](https://api.cyhub.ai/models/suno)
- Similar models: [Eleven Music API](https://api.cyhub.ai/en/models/eleven-music/api.md)
- [API documentation](https://api.cyhub.ai/docs.md?lang=en)
- [API errors and how to handle them](https://api.cyhub.ai/docs/errors.md?lang=en)