Skip to main content
POST
cURL
Начните с этой страницы, если вам нужен основной эндпоинт для генерации музыки в Suno API. Полный список эндпоинтов, рекомендации по рабочему процессу и связанные ссылки см. в обзоре Suno API. Старые модели Suno полностью сняты с поддержки. Сейчас поддерживаются только chirp-v6, chirp-v6-wild и chirp-v6-mini. Если всё ещё передано снятое с поддержки название модели, оно автоматически сопоставляется с chirp-v6. См. Соответствие моделей. После создания пользовательской модели укажите mv = chirp-custom:{model_id}, чтобы генерировать в её стиле. См. Создание модели. persona_id и chirp-custom нельзя использовать вместе.

Авторизации

TT-API-KEY
string
header
обязательно

Вы можете получить API-ключ в панель управления TTAPI.

Тело

application/json
custom
boolean
по умолчанию:false
обязательно

Использовать пользовательский режим.

  • true: Аудио будет создано на основе текста песни
  • false: Аудио будет создано по промптам режима вдохновения
instrumental
boolean
по умолчанию:false
обязательно

Генерировать инструментальную музыку.

  • true: Генерировать только инструментальную музыку
  • false: Генерировать трек с вокалом и текстом
    • В режиме вдохновения обязателен параметр gpt_description_prompt
    • В пользовательском режиме обязателен параметр промпт
mv
enum<string>
по умолчанию:chirp-v6
обязательно

Модель для использования. Доступны chirp-v6, chirp-v6-wild, chirp-v6-mini. Старые модели Suno полностью сняты с поддержки; передача старого названия сопоставляет его с chirp-v6. См. Соответствие моделей. После создания пользовательской модели можно передать chirp-custom:{model_id}. См. Создание модели. persona_id и chirp-custom нельзя использовать вместе.

Доступные опции:
chirp-v6,
chirp-v6-wild,
chirp-v6-mini
gpt_description_prompt
string

Промпт для режима вдохновения.

Если пользовательский режим не используется (custom=false), этот параметр обязателен. Текст песни будет автоматически сгенерирован из этого промпта. Максимальная длина: 3000 символов.

Пример:

"Night city lo-fi piano with rain ambience, soft vocal phrases, theme: \"Under the city lights\""

prompt
string

Текст песни.

Используется в пользовательском режиме (custom=true). Обязателен, когда instrumental = false. Текст будет использован и исполнен в сгенерированном треке.. Максимальная длина: 5000 символов.

title
string

Название музыки.

Используется в пользовательском режиме (custom=true). Максимальная длина: 80 символов.

tags
string

Музыкальный стиль или жанр.

Используется в пользовательском режиме (custom=true). Максимальная длина: 1000 символов.

Пример:

"rock, blues, hip-hop, r&b"

negative_tags
string

Музыкальные стили или жанры, которые нужно исключить из генерации.

Используется в пользовательском режиме (custom=true).

style_weight
number

Вес музыкального стиля, диапазон: 0,00–1,00.

Используется в пользовательском режиме. Допустимый диапазон: 0 <= x <= 1.

Пример:

0.5

weirdness_constraint
number

Вес аудиокреативности (странности), диапазон: 0,00–1,00.

Используется в пользовательском режиме. Допустимый диапазон: 0 <= x <= 1.

Пример:

0.5

audio_weight
number

Вес звука, диапазон: 0,00–1,00.

Используется в пользовательском режиме. Допустимый диапазон: 0 <= x <= 1.

Пример:

0.5

duration
int

Длительность аудио (в секундах).

Используется только в пользовательском режиме. Допустимое значение: от 10 до 360 секунд.

auto_lyrics
boolean
по умолчанию:false

Автоматически генерировать текст. Только для пользовательского режима.

  • true: Входной текст будет креативно переписан, похожим образом на эффект режима вдохновения
  • false: Использовать предоставленный текст напрямую для генерации музыки
vocal_gender
enum<string>

Вокальный пол.

  • Мужской: Мужской голос

  • Женский: женский голос

Доступные опции:
Male,
Female
persona_id
string

Идентификатор музыкального стиля. Только пользовательский режим.

Используйте этот параметр для создания музыки определенного стиля. Нельзя использовать вместе с mv=chirp-custom:{model_id}.

variety
enum<string>
по умолчанию:normal

Разнообразие стиля. Управляет тем, насколько результат отличается от указанного стиля.

  • off: Exact style (точный стиль)
  • normal: Balanced variety (сбалансированное разнообразие)
  • high: Distinct styles (заметные различия стилей)
  • extra: Bold exploration (смелое исследование)
  • max: Unreasonably varied (крайне разнообразно)
Доступные опции:
off,
normal,
high,
extra,
max
max_mode
boolean
по умолчанию:false

Использовать больше вычислительных ресурсов, чтобы максимизировать согласованность на протяжении всей песни. Только в пользовательском режиме.

  • false: Нет (по умолчанию)
  • true: Да. При включении расход квоты удваивается
audio_format
enum<string>

Формат аудио audioUrl после успешного завершения задачи.

Доступные опции:
mp3,
m4a,
wav
Пример:

"mp3"

hookUrl
string

URL обратного уведомления

isStorage
boolean
по умолчанию:true
устарело

Сохранять ли сгенерированный звук.

  • true: аудио будет сохранено и будет возвращено TTAPI CDN URL.
  • false: будет возвращен исходный источник URL.

Ответ

Запрос выполнен успешно

status
string
обязательно
Пример:

"SUCCESS"

message
string
обязательно
Пример:

"success"

data
object
обязательно
Пример:
Последнее изменение 9 сентября 2026 г.