Suno Music Generate

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

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

Обзор

Характеристика	Значение
ID модели	`suno/generate`
Эндпоинт	`/api/v1/media`
Max prompt	5 000 символов
Max style	1 000 символов
Max title	80 символов
Версии	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());

import requests

response = requests.post(
    'https://polza.ai/api/v1/media',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'model': 'suno/generate',
        'input': {
            'prompt': 'Энергичный электронный трек для тренировки с драйвовым битом'
        }
    }
)

result = response.json()
generation_id = result['id']
print(f'ID генерации: {generation_id}')

# Проверка статуса
status = requests.get(
    f'https://polza.ai/api/v1/media/{generation_id}',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'}
)
print(status.json())

# Создание запроса на генерацию музыки
curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/generate",
    "input": {
      "prompt": "Энергичный электронный трек для тренировки с драйвовым битом"
    }
  }'

# Проверка статуса генерации
curl "https://polza.ai/api/v1/media/{id}" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>"

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);

import requests

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

print(response.json())

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/generate",
    "input": {
      "prompt": "[Verse]\nГород спит, а мы не спим\nОгни мерцают в тишине\n\n[Chorus]\nМы летим, мы летим\nНад ночным городом во сне",
      "style": "Pop, Synth-pop, Dream pop",
      "title": "Ночной город"
    }
  }'

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

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);

import requests

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

print(response.json())

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/generate",
    "input": {
      "prompt": "Спокойная фортепианная мелодия для учёбы и концентрации",
      "style": "Ambient, Piano, Lo-fi",
      "title": "Focus Time"
    }
  }'

Параметры

Параметр	Обязательный	Описание
`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`

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

Простой режим vs Custom Mode

В простом режиме достаточно передать prompt с описанием желаемой музыки — Suno сам сгенерирует текст и подберёт стиль. В custom mode вы контролируете текст песни (prompt), стиль (style) и название (title).

Как писать промпты

Описывайте настроение, жанр и инструменты: «Меланхоличная акустическая баллада с гитарой и скрипкой». Для custom mode используйте структурные теги: [Verse], [Chorus], [Bridge], [Outro].

Выбор версии модели

V5 — последняя и наиболее качественная версия, используется по умолчанию. Более ранние версии (V4, V3.5) могут давать другой звук — экспериментируйте при необходимости.

Указание стиля

Перечисляйте стили через запятую: Rock, Alternative, Energetic. Можно комбинировать жанры с настроением и темпом.

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

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

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

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

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

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

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

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

Начало работы

Продвинутое

Генерация медиа

Интеграции

Suno Music Generate

Обзор

Возможности

Text-to-Music

Custom Mode

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

Выбор версии

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

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

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

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

Параметры

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

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

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

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

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

​Обзор

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

Text-to-Music

Custom Mode

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

Выбор версии

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

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

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

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

​Параметры

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

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

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

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

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

Обзор

Возможности

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

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

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

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

Параметры

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

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

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