Перейти к основному содержанию
Генерация музыки от Suno — вокальные и инструментальные треки из текстового описания. Поддерживает версии V3.5–V5, custom mode с текстом песни и настройкой стиля. Стоимость: 15 ₽ за генерацию.
Полная документация API: Генерация медиа

​
Обзор

ХарактеристикаЗначение
ID моделиsuno/generate
Эндпоинт/api/v1/media
Max prompt5 000 символов
Max style1 000 символов
Max title80 символов
ВерсииV5 (по умолчанию), V4_5ALL, V4_5PLUS, V4_5, V4, V3_5
Стоимость15 ₽ за запрос

​
Возможности

Text-to-Music

Создание музыки по текстовому описанию

Custom Mode

Написание текста песни, выбор стиля и названия трека

Инструментал

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

Выбор версии

6 версий модели от V3.5 до V5

​
Примеры запросов

​
Простой запрос

const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'suno/generate',
    input: {
      prompt: 'Энергичный электронный трек для тренировки с драйвовым битом'
    }
  })
});

const result = await response.json();
console.log('ID генерации:', result.id);

// Проверка статуса
const status = await fetch(`https://polza.ai/api/v1/media/${result.id}`, {
  headers: { 'Authorization': 'Bearer <POLZA_AI_API_KEY>' }
});
console.log(await status.json());

​
Custom Mode (текст песни + стиль)

const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'suno/generate',
    input: {
      prompt: '[Verse]\nГород спит, а мы не спим\nОгни мерцают в тишине\n\n[Chorus]\nМы летим, мы летим\nНад ночным городом во сне',
      style: 'Pop, Synth-pop, Dream pop',
      title: 'Ночной город'
    }
  })
});

const result = await response.json();
console.log(result);

​
Инструментальный трек

const response = await fetch('https://polza.ai/api/v1/media', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'suno/generate',
    input: {
      prompt: 'Спокойная фортепианная мелодия для учёбы и концентрации',
      style: 'Ambient, Piano, Lo-fi',
      title: 'Focus Time'
    }
  })
});

const result = await response.json();
console.log(result);

​
Параметры

ПараметрОбязательныйОписание
modelДаsuno/generate
promptДаОписание трека или текст песни (до 5 000 символов). В custom mode используется как lyrics — поддерживает теги [Verse], [Chorus], [Bridge] и др.
styleНетЖанр/стиль музыки (до 1 000 символов). Обязателен при использовании custom mode. Пример: Pop, Electronic, Upbeat
titleНетНазвание трека (до 80 символов). Обязателен при использовании custom mode
versionНетВерсия модели: V5 (по умолчанию), V4_5ALL, V4_5PLUS, V4_5, V4, V3_5

​
Советы и лучшие практики

В простом режиме достаточно передать prompt с описанием желаемой музыки — Suno сам сгенерирует текст и подберёт стиль. В custom mode вы контролируете текст песни (prompt), стиль (style) и название (title).
Описывайте настроение, жанр и инструменты: «Меланхоличная акустическая баллада с гитарой и скрипкой». Для custom mode используйте структурные теги: [Verse], [Chorus], [Bridge], [Outro].
V5 — последняя и наиболее качественная версия, используется по умолчанию. Более ранние версии (V4, V3.5) могут давать другой звук — экспериментируйте при необходимости.
Перечисляйте стили через запятую: Rock, Alternative, Energetic. Можно комбинировать жанры с настроением и темпом.

​
Асинхронная генерация

Генерация музыки — асинхронный процесс. После отправки запроса вы получите id, который нужно использовать для проверки статуса:
1

Отправка запроса

POST запрос на /api/v1/media возвращает id генерации
2

Проверка статуса

GET запрос на /api/v1/media/{id} возвращает текущий статус
3

Получение результата

Когда статус completed, в ответе будут URL аудиофайла, обложка, название и длительность трека

​
Следующие шаги

Статус генерации

Проверка статуса генерации медиа

Операции над медиа

Дополнительные операции над результатами