Новинка: Nano Banana 2.1Попробовать модель
API Hubs
/MUSIC/suno
Аудио

Suno API

Генерация звука Suno: создавайте песни, тексты песен и звуковые эффекты, а также редактируйте существующие треки (расширение, кавер, основы, затухания, мэшап, ремастер, MV, персона и т. д.) — одна модель выбирается полем «действие».

  • Текст в музыку
  • Аудиореференс
  • Несколько действий
Попробовать модельПолучить API-ключДокументация

От

0.075 coins

за генерацию

53 параметров · 31 вариантов цен

Песочница Suno

Ввод

Пользовательский режим: подробный текст песни или промпт, а также текст или описание звука.

URL аудиофайла для обработки

music-video: URL обложки внутри кольца. По умолчанию используется обложка исходной дорожки, если она доступна.

voice: URL записи голоса.

voice: URL записи проверочной фразы.

Public audio URLs. inspo: 1–4 inspiration references; custom-model: 6–24 training tracks (MP3, WAV or M4A).

Войдите, чтобы запустить

Запуски списываются с вашего баланса.

Вывод

Вывод появится здесь.

Проверьте цену и запустите модель. Результат появится здесь; API-ключ для браузера не нужен.

Цены на Suno API

ВариантЦена за генерацию
music0.075 coins
bpm0.002 coins
vox0.002 coins
wav0.002 coins
concat0.002 coins
boost-style0.002 coins
music-video0.002 coins
timestamped-lyrics0.002 coins
upload0.006 coins
crop0.012 coins
lyrics0.012 coins
fade-in0.012 coins
fade-out0.012 coins
remove-section0.012 coins
sound0.015 coins
voice0.024 coins
adjust-speed0.036 coins
midi0.075 coins
cover0.075 coins
extend0.075 coins
mashup0.075 coins
sample0.075 coins
add-stem0.075 coins
remaster0.075 coins
add-vocals0.075 coins
music-cover0.075 coins
replace-section0.075 coins
add-instrumental0.075 coins
inspo0.102 coins
stems0.15 coins
stems-all0.36 coins

Быстрый старт

Полная справка по API →
1curl -X POST https://api.apihubs.ru/api/v1/generation/create \
2  -H "Authorization: Bearer $API_STOCK_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "suno",
6    "input": {
7      "action": "music",
8      "makeInstrumental": false,
9      "maxMode": false,
10      "aspectRatio": "9:16",
11      "quality": "compact"
12    }
13  }'

Параметры

ИмяТипОбязательноеПо умолчаниюОписание
actionstringНетmusicОперация SunoОдно из значений: music, extend, cover, add-instrumental, add-vocals, sound, stems, stems-all, wav, lyrics, voice, timestamped-lyrics, boost-style, music-cover, replace-section, music-video, inspo, upload, remaster, add-stem, vox, remove-section, crop, fade-in, fade-out, adjust-speed, concat, mashup, sample, midi, bpm, custom-model
mvstringНет—Версия движка. Для аудиоопераций: v6 (по умолчанию) | v6-wild | v6-mini | custom. Снятые с поддержки версии v3.5 … v5.5 по-прежнему принимаются и выполняются на v6. Для lyrics: remi-v1 | default. Не используется в stems/stems-all/wav/voice. variety, maxMode, audioFormat, duration и customModelId требуют движка V6 (любое значение, кроме custom).
custombooleanНет—false — простой режим, true — пользовательский режим.
gptDescriptionPromptstringНет—Простой режим: описание песни или эффекта с необязательным текстом.
promptstringНет—Пользовательский режим: подробный текст песни или промпт, а также текст или описание звука.
tagsstringНет—Пользовательский режим: теги жанра и стиля.
titlestringНет—Название результата.
makeInstrumentalbooleanНетfalseСоздать только инструментальную дорожку без вокала.
negativeTagsstringНет—Стили, которых следует избегать в пользовательском режиме или sound.
personaIdstringНет—ID пользовательского голоса, который исполнит сгенерированную музыку.
customModelobjectНет—Встроенное описание пользовательской модели. Обязательно при mv=custom.
customModelIdstringНет—Id of a reusable custom model created by the `custom-model` action (its `output.customModelId`). Generates in that model's style; cannot be combined with mv or personaId.
varietystringНет—Style variation: off | normal | high | extra | max. V6 generative actions.Одно из значений: off, normal, high, extra, max
maxModebooleanНетfalseMax mode: higher-quality V6 generation, billed at twice the regular price. Requires custom mode, except on inspo and replace-section.
audioFormatstringНет—Output audio format: mp3 | m4a | wav. V6 generative actions plus sound, remaster, stems and stems-all.Одно из значений: mp3, m4a, wav
durationnumberНет—music / extend / cover: target length in seconds (10–360), custom mode only. The actual length is decided by the model.
audioUrlstringНет—URL аудиофайла для обработки
continueAtnumberНет—extend: time in seconds where the extension should begin (at least 1 for a sourceTaskId or audioUrl source)
sourceTaskIdstringНет—Ссылка на одну из предыдущих генераций Suno по её taskId. Используется операциями с состоянием: extend, music-cover, replace-section, timestamped-lyrics, music-video, voice и wav.
audioIdstringНет—Дорожка для обработки, заданная её ID из `output.tracks[].audioId` предыдущей генерации. Обычно генерация создаёт две дорожки; не указывайте значение, чтобы использовать первую.
fullLyricsstringНет—replace-section: полный текст всей песни после редактирования.
authorstringНет—music-video: имя исполнителя или автора на обложке, максимум 50 символов.
domainNamestringНет—music-video: бренд или адрес сайта в нижнем водяном знаке, максимум 50 символов.
aspectRatiostringНет9:16music-video: соотношение сторон результатаОдно из значений: 9:16, 16:9, 1:1, 3:4, 4:3
backgroundColorsstring[]Нет—music-video: от одного до четырёх HEX-цветов размытого градиентного фона, например ["#1B2635", "#8A6A4F"].
imageUrlstringНет—music-video: URL обложки внутри кольца. По умолчанию используется обложка исходной дорожки, если она доступна.
qualitystringНетcompactmusic-video: качество результата. `compact` — небольшой файл для публикации, около 5 МБ на 3 минуты; `high` — более чёткое видео уровня 720p примерно вдвое большего размера; `max` — уровень 1080p, примерно в четыре раза больше compact.Одно из значений: compact, high, max
startSnumberНет—Начало изменяемого диапазона в секундах. Используется remove-section, crop и sample для диапазона, replace-section для заменяемого участка, vox и voice-from-track для вокального окна.
endSnumberНет—Конец изменяемого диапазона в секундах, должен быть больше startS. Список использующих его операций приведён в описании startS.
bpmnumberНет—sound: темп в ударах в минуту (BPM).
keystringНет—sound: музыкальная тональность: мажор C–B или минор Cm–Bm.
typestringНет—sound: `one-shot` или `loop`. По умолчанию one-shot.Одно из значений: one-shot, loop
voiceAudioUrlstringНет—voice: URL записи голоса.
verificationAudioUrlstringНет—voice: URL записи проверочной фразы.
phraseIdstringНет—voice: ID фразы из эндпоинта verification-phrase.
namestringНет—voice / custom-model: name
descriptionstringНет—voice: описание голоса.
stylesstringНет—voice: жанровые теги, например 'funk edm'.
singerSkillLevelstringНет—voice: уровень мастерства вокалиста.Одно из значений: Beginner, Intermediate, Advanced, Professional
audioUrlsstring[]Нет—Public audio URLs. inspo: 1–4 inspiration references; custom-model: 6–24 training tracks (MP3, WAV or M4A).
styleWeightnumberНет—Вес влияния стиля (0,00–1,00).
weirdnessConstraintnumberНет—Уровень креативности и необычности результата (0,00–1,00).
audioWeightnumberНет—Вес влияния аудио (0,00–1,00)
vocalGenderstringНет—Пол вокала: Male (мужской) или Female (женский).Одно из значений: Male, Female
autoLyricsbooleanНет—inspo: творчески переработать предоставленный текст песни.
variationCategorystringНет—remaster: интенсивность изменений: subtle, normal или high.Одно из значений: subtle, normal, high
stemTypestringНет—stems: какую дорожку извлечь, например lead_vocal, backing_vocals, drum_kit, bass, piano или electric_guitar. По умолчанию lead_vocal.
voxAudioIdstringНет—Deprecated and ignored: a persona is now created straight from the track (voice with sourceTaskId), no vox extraction needed.
durationSnumberНет—fade-in / fade-out: длительность затухания в секундах.
speednumberНет—adjust-speed: множитель скорости (0,25–4).
keepPitchbooleanНет—adjust-speed: сохранять исходную высоту тона. По умолчанию включено.
sourceTaskIdsstring[]Нет—mashup: ровно два taskId предыдущих генераций Suno, которые нужно объединить в ремикс.
audioIdsstring[]Нет—mashup: массив, соответствующий sourceTaskIds и выбирающий дорожку каждого источника по audioId из output.tracks[].audioId; пропустите элемент, чтобы использовать первую дорожку источника.

Часто задаваемые вопросы

Сколько стоит Suno?

Suno стоит от $0.075 за генерацию в API Hubs. Итоговая цена зависит от выбранных настроек.

Когда вышла Suno?

Suno выпущена 9 сентября 2026 г. и доступна через API Hubs.

Как получить API-ключ для Suno?

Создайте аккаунт и API-ключ в API Hubs, затем пополните баланс. Один ключ подходит для Suno и остальных моделей каталога.

Как вызвать API Suno?

Отправьте POST-запрос на https://api.apihubs.ru/api/v1/generation/create с вашим API-ключом и моделью "suno". Проверяйте результат по task id или получайте его через webhook.

Какие входные параметры принимает Suno?

Suno принимает 53 параметров. Типы, значения по умолчанию и допустимые варианты указаны выше.

Что произойдёт, если запрос к Suno завершится ошибкой?

API Hubs автоматически повторяет запрос через резервного поставщика. Если все поставщики завершаются с ошибкой, списание возвращается на ваш баланс.

Можно ли использовать Suno с тем же API-ключом, что и другие модели?

Да. Ваш ключ API Hubs и баланс подходят для Suno и остальных моделей каталога.

Руководства