Аудио

Suno V5

Suno API генерирует музыку студийного качества из промптов, стилей и текстов, возвращая два трека за один запуск с асинхронной доставкой, удобной для продакшена.

$0.12 / use

2 трека за запускАсинхронный рабочий процессУправление промптом и текстом песенMP3 + обложка

Параметры

Model Version*

Custom Mode*

Включено

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

Отключено

Vocal Gender Preference

Результат

Сгенерированный контент появится здесь

Конечные точки

POSThttps://api.apixo.ai/api/v1/generateTask/sunoСоздать задачу

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}Статус опроса

Аутентификация

Проверка доступа к API...

Войдите, чтобы получить бесплатные кредиты, протестировать Playground и перейти к интеграции API.

Тело запроса

request_type

async

Используйте callback с параметром callback_url для вебхуков.

provider

official

Соответствует руководству Seedance 2.0.

input

объект

Режим, промпт, референсы, размер, длительность и настройки аудио.

Параметры

request_typeобязательно

Типselect

Use async to poll or callback to receive a webhook when ready.async · callback

callback_urlусловный

Типtext

Publicly accessible URL for callback mode.Только в request_type=callback

modeобязательно

Типselect

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customModeобязательно

Типboolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

titleобязательно

Типtext

Appears in metadata and can steer theme. Required when Custom Mode is on.Только в customMode=

styleобязательно

Типstring

Describe genre/mood/instrumentation. Required in Custom Mode.Только в customMode=

promptусловный

Типstring

Provide full lyrics for sung output. Required when Instrumental is off.Только в customMode=

songDescriptionобязательно

Типstring

Simple mode: one field to steer both style and topic when Custom Mode is off.Только в customMode=

instrumentalобязательно

Типboolean

Turn on to generate backing track without vocals.

negativeTagsусловный

Типstring

Negative TagsТолько в customMode=

styleWeightусловный

Типslider

How strongly to follow the Style description.Только в customMode=

weirdnessConstraintусловный

Типslider

Push creativity/experimentation. Higher = wilder.Только в customMode=

audioWeightусловный

Типslider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.Только в customMode=

vocalGenderусловный

Типselect

Best-effort vocal timbre preference (custom mode only).f · mТолько в customMode=

Параметр	Тип	Обязательно	Описание
`request_type`	select	обязательно	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	условный	Publicly accessible URL for callback mode.Только в request_type=callback
`mode`	select	обязательно	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	обязательно	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	обязательно	Appears in metadata and can steer theme. Required when Custom Mode is on.Только в customMode=
`style`	string	обязательно	Describe genre/mood/instrumentation. Required in Custom Mode.Только в customMode=
`prompt`	string	условный	Provide full lyrics for sung output. Required when Instrumental is off.Только в customMode=
`songDescription`	string	обязательно	Simple mode: one field to steer both style and topic when Custom Mode is off.Только в customMode=
`instrumental`	boolean	обязательно	Turn on to generate backing track without vocals.
`negativeTags`	string	условный	Negative TagsТолько в customMode=
`styleWeight`	slider	условный	How strongly to follow the Style description.Только в customMode=
`weirdnessConstraint`	slider	условный	Push creativity/experimentation. Higher = wilder.Только в customMode=
`audioWeight`	slider	условный	Balance audio vs lyrical fidelity. Higher favors audio fidelity.Только в customMode=
`vocalGender`	select	условный	Best-effort vocal timbre preference (custom mode only).f · mТолько в customMode=

Пример (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

Полная документация API

Примеры результатов

Сгенерировано с помощью Suno V5 API на APIXO

2 Треки

Neon Freeway Nights

Просмотреть

Полное руководство

Что такое Suno API?

Suno API — это интерфейс генерации текста в музыку, разработанный для быстрых рабочих процессов. Он может превращать промпты, теги стилей и пользовательские тексты в два полных песенных трека с обложками.

Это делает модель подходящей для инструментов создания контента, генерации брендированных материалов и автоматизированного производства музыки, где скорость итераций важнее ручной композиции.

Как устроен рабочий процесс генерации

Отправьте запрос на генерацию с параметрами только промпта или режима пользовательских текстов песен.
Получайте статус задачи асинхронно через опрос или callback-endpoint.
При успешном выполнении расходуются два сгенерированных трека плюс соответствующие метаданные обложки.

Технические характеристики Suno API

Операционные характеристики, важные для интеграции продукта и бэкенда.

Результаты

2 трека за генерацию

Панель управления

Стиль, странность, вес аудио

Режимы генерации

Режим только промпта и режим кастомного текста песен

Доставка

Асинхронный опрос или callback

Ключевые возможности

Двухдорожечный вывод

Каждая генерация возвращает два варианта песни, ускоряя A/B тестирование и итерации для творческих команд.

Слайдеры творческого контроля

Настраивайте вес стиля, странность (weirdness) и вес аудио, чтобы переходить от стандартных коммерческих треков к экспериментальным текстурам.

Рабочие процессы с текстами песен и вокалом

Поддерживает генерацию только по промпту и режим пользовательских текстов с опциональными предпочтениями по инструменталу и полу вокалиста.

Готовность к асинхронной интеграции

Работает со стратегиями опроса (polling) или обратного вызова (callback), что упрощает интеграцию в серверные очереди задач.

Что вы можете создать?

Генерация музыки в приложении

Генерируйте брендированные музыкальные фрагменты и треки для UGC, коротких видео и инструментов создания контента для соцсетей.

Брендинг подкастов и видео

Создавайте вступительные и завершающие треки, заставки и повторяющиеся темы с управляемым настроением и темпом.

Саундтреки для короткометражного контента

Создавайте фоновую музыку для TikTok, Shorts и Reels с быстрой итерацией стилей и лирических хуков.

Игровое и интерактивное аудио

Прототипируйте фоновые циклы, темы меню и легкие идеи саундтреков для игр и интерактивных проектов.

Примечания и ограничения

Каждая генерация возвращает ровно две дорожки; количество результатов не настраивается.
Рабочий процесс Playground является асинхронным; оркестрация обратных вызовов доступна на уровне API.
Длина промпта/текста в режиме Custom ограничена 5 000 символов в поддерживаемых версиях.
Пол и характеристики вокала являются рекомендательными настройками, а не строгими гарантиями.

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

Начать разработку

Попробуйте Playground выше, а затем переходите к документации API, когда будете готовы к интеграции.

Попробовать Playground Документация API

Suno V5

Примеры результатов

Что такое Suno API?

Как устроен рабочий процесс генерации

Технические характеристики Suno API

Результаты

Панель управления

Режимы генерации

Доставка

Ключевые возможности

Двухдорожечный вывод

Слайдеры творческого контроля

Рабочие процессы с текстами песен и вокалом

Готовность к асинхронной интеграции

Что вы можете создать?

Генерация музыки в приложении

Брендинг подкастов и видео

Саундтреки для короткометражного контента

Игровое и интерактивное аудио

Примечания и ограничения

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

Могу ли я сгенерировать только один трек вместо двух?

Могу ли я заставить модель выдать точный текст песни?

Является ли этот API синхронным?

Какой тип файла возвращается?

Начать разработку