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

# Suno — генерация музыки

> Обзор API генерации и редактирования музыки Suno, жизненный цикл задач и цены

Серия Suno покрывает полный цикл работы с ИИ-музыкой: генерация, продление, редактирование, разделение дорожек и анализ. Все операции используют один endpoint и различаются сегментом `{operation}` в пути:

```
POST https://toapis.com/v1/music/generations/{operation}
```

Все операции — **асинхронные задачи**: после отправки возвращается ID задачи, результат запрашивается через endpoint статуса. Медиа-URL (аудио, обложки, видео) зеркалируются на наш CDN и доступны постоянно.

## Authorizations

<ParamField header="Authorization" type="string" required>
  Bearer Token. Получить API Key:[страница управления](https://toapis.com/console/token)

  ```
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

## Общие положения

* `model` в теле запроса всегда `"suno"`
* Операции над существующими работами принимают `task_id`(локальный ID, префикс `tsk_aud_`); при нескольких треках укажите `audio_index`
* `custom` переключает режим: `true` — кастомный текст(`prompt` — слова, работают `title`/`style`/`negative_tags`); `false`/опущен — режим вдохновения(`prompt`/`gpt_description` — описание музыки)
* `max_mode` — высококачественный тариф(×2), действует только для операций с колонкой **Max**; для операций с `custom` требуется effective custom = `true`

## Операции и цены

### Генерация

| operation | Описание | Цена | Max |
| - | - | - | - |
| `generation` | Генерация музыки(по умолч.) | \$0.05 | \$0.10 |
| `lyrics` | Генерация текста | \$0.008 | - |
| `inspo` | Генерация по референсам | \$0.068 | \$0.136 |
| `sounds` | Звуковые эффекты | \$0.0096 | - |
| `upsampleTags` | Расширение тегов стиля | \$0.004 | - |

### Загрузка

| operation | Описание | Цена | Max |
| - | - | - | - |
| `uploadTask` | Регистрация загруженного аудио | \$0.004 | - |
| `uploadCover` | Загрузка + кавер | \$0.05 | \$0.10 |
| `uploadExtend` | Загрузка + продление | \$0.05 | \$0.10 |

### Продление и преобразование

| operation | Описание | Цена | Max |
| - | - | - | - |
| `extend` | Продление с метки времени | \$0.05 | \$0.10 |
| `coverSong` | Кавер в новом стиле | \$0.05 | \$0.10 |
| `remaster` | Ремастеринг | \$0.05 | - |
| `mashup` | Мэшап двух треков | \$0.05 | \$0.10 |
| `replaceMusic` | Перезапись фрагмента | \$0.05 | \$0.10 |
| `sample` | Ресемплинг(только из upload) | \$0.05 | \$0.10 |

### Стемы

| operation | Описание | Цена |
| - | - | - |
| `stems` | Вокал / минус | \$0.10 |
| `stemsAll` | Полное разделение инструментов | \$0.24 |
| `addStem` | Добавить инструмент | $0.05(Max $0.10) |
| `addVocals` | Добавить вокал к загрузке | $0.05(Max $0.10) |
| `addInstrumental` | Добавить минус к загрузке | $0.05(Max $0.10) |

### Монтаж

| operation | Описание | Цена |
| - | - | - |
| `crop` | Вырезать фрагмент | \$0.008 |
| `removeSection` | Удалить фрагмент | \$0.008 |
| `fadeIn` | Фейд в начале | \$0.008 |
| `fadeOut` | Фейд в конце | \$0.008 |
| `adjustSpeed` | Смена темпа(с сохранением тона) | \$0.024 |
| `concat` | Склейка сегментов extend | \$0.004 |

### Анализ и экспорт

| operation | Описание | Цена |
| - | - | - |
| `midi` | Аудио → MIDI-ноты | \$0.05 |
| `bpm` | Анализ BPM | \$0.0008 |
| `alignedLyrics` | Тайминг текста | \$0.0008 |
| `download` | Мультиформат(mp3/m4a/wav) | \$0.0016 |
| `generateMp4` | Видео с текстом | \$0.004 |
| `wav` | WAV-выгрузка(устар., см. `download`) | \$0.0016 |

### Ассеты(продвинутые)

| operation | Описание | Цена |
| - | - | - |
| `persona` | Вокальная персона | \$0.004 |
| `createVoice` | Клонирование голоса(нужен чистый вокал) | \$0.016 |
| `vox` | Извлечение вокала(устар., см. `persona`) | \$0.004 |
| `createModel` | Обучение модели(6-24 трека) | \$0.96 |

## Жизненный цикл задачи

```
submitted → queued / in_progress → completed / failed
```

* При сбое предоплата возвращается автоматически
* `download`/`midi`/`bpm`/`alignedLyrics` возвращают структурированные данные — см.[статус задачи](/docs/ru/api-reference/tasks/music-status)

<CardGroup cols={2}>
  <Card title="Генерация" icon="music" href="/docs/ru/api-reference/audios/suno/generation">
    generation / inspo / sounds / lyrics
  </Card>

  <Card title="Продление и загрузка" icon="upload" href="/docs/ru/api-reference/audios/suno/upload-extend">
    extend / uploadTask / uploadCover / uploadExtend
  </Card>

  <Card title="Монтаж и преобразование" icon="scissors" href="/docs/ru/api-reference/audios/suno/edit">
    crop / fadeIn / fadeOut / replaceMusic / mashup / ...
  </Card>

  <Card title="Анализ и экспорт" icon="chart-line" href="/docs/ru/api-reference/audios/suno/analysis">
    midi / bpm / alignedLyrics / download / generateMp4
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.