Suno
Suno — генерация музыки
Обзор API генерации и редактирования музыки Suno, жизненный цикл задач и цены
Серия Suno покрывает полный цикл работы с ИИ-музыкой: генерация, продление, редактирование, разделение дорожек и анализ. Все операции используют один endpoint и различаются сегментом {operation} в пути:
POST https://toapis.com/v1/music/generations/{operation}Все операции — асинхронные задачи: после отправки возвращается ID задачи, результат запрашивается через endpoint статуса. Медиа-URL (аудио, обложки, видео) зеркалируются на наш CDN и доступны постоянно.
Authorizations
AuthorizationstringзаголовокобязательноBearer Token. Получить API Key:страница управления
Authorization: Bearer YOUR_API_KEYОбщие положения
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возвращают структурированные данные — см.статус задачи