Suno Mashup

Suno Mashup — инструмент Suno для создания нового трека на основе двух исходных песен. На вход подаются ссылки на два аудиофайла, на выходе — мэшап с переработанным текстом и музыкальным сочетанием исходных композиций.

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

Обзор

Характеристика	Значение
ID модели	`suno/mashup`
Эндпоинт	`/api/v1/media`
Max prompt	500 символов (обычный режим) / 5 000 символов (custom mode)
Max style	1 000 символов
Max title	80 символов
Количество исходных треков	Ровно 2 (по `uploadUrlList`)
Версии	V6 (по умолчанию), V6_MINI, V6_WILD

Возможности

Смешивание двух треков

Объединение двух исходных аудио в один мэшап-трек

Переработка текста

Формирование нового текста на основе исходного материала

Custom Mode

Свой текст песни, стиль и название через custom mode

Выбор версии

V6, V6_MINI или V6_WILD — под задачу и нужное качество

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

Простой мэшап

cURL
Python
TypeScript

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/mashup",
    "input": {
      "prompt": "Энергичный поп-рок мэшап с ярким припевом",
      "uploadUrlList": [
        "https://example.com/track-1.mp3",
        "https://example.com/track-2.mp3"
      ]
    }
  }'

import requests

response = requests.post(
    'https://polza.ai/api/v1/media',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'model': 'suno/mashup',
        'input': {
            'prompt': 'Энергичный поп-рок мэшап с ярким припевом',
            'uploadUrlList': [
                'https://example.com/track-1.mp3',
                'https://example.com/track-2.mp3'
            ]
        }
    }
)
print(response.json())

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/mashup',
    input: {
      prompt: 'Энергичный поп-рок мэшап с ярким припевом',
      uploadUrlList: [
        'https://example.com/track-1.mp3',
        'https://example.com/track-2.mp3'
      ]
    }
  })
});

console.log(await response.json());

Custom Mode (свой текст, стиль, название)

cURL
Python
TypeScript

curl -X POST "https://polza.ai/api/v1/media" \
  -H "Authorization: Bearer <POLZA_AI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/mashup",
    "input": {
      "customMode": true,
      "prompt": "[Verse]\nДва сердца бьются в одном ритме\n[Chorus]\nМы — новый звук, мы — новый мир",
      "style": "Pop, Electronic, Upbeat",
      "title": "Новый ритм",
      "uploadUrlList": [
        "https://example.com/track-1.mp3",
        "https://example.com/track-2.mp3"
      ]
    }
  }'

import requests

response = requests.post(
    'https://polza.ai/api/v1/media',
    headers={'Authorization': 'Bearer <POLZA_AI_API_KEY>'},
    json={
        'model': 'suno/mashup',
        'input': {
            'customMode': True,
            'prompt': '[Verse]\nДва сердца бьются в одном ритме\n[Chorus]\nМы — новый звук, мы — новый мир',
            'style': 'Pop, Electronic, Upbeat',
            'title': 'Новый ритм',
            'uploadUrlList': [
                'https://example.com/track-1.mp3',
                'https://example.com/track-2.mp3'
            ]
        }
    }
)
print(response.json())

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/mashup',
    input: {
      customMode: true,
      prompt: '[Verse]\nДва сердца бьются в одном ритме\n[Chorus]\nМы — новый звук, мы — новый мир',
      style: 'Pop, Electronic, Upbeat',
      title: 'Новый ритм',
      uploadUrlList: [
        'https://example.com/track-1.mp3',
        'https://example.com/track-2.mp3'
      ]
    }
  })
});

console.log(await response.json());

Параметры

Параметр	Тип	Обязательный	Описание
`model`	string	Да	`suno/mashup`
`uploadUrlList`	string[]	Да	Ровно 2 публичные URL-ссылки на аудио для смешивания
`prompt`	string	Да	Описание трека или lyrics. До 500 символов в обычном режиме, до 5 000 — в custom mode
`customMode`	boolean	Нет	Расширенный режим с собственным текстом песни. По умолчанию `false`
`style`	string	Нет	Жанр/стиль музыки, до 1 000 символов. Обязателен при использовании custom mode
`title`	string	Нет	Название трека, до 80 символов. Обязателен при использовании custom mode
`version`	string	Нет	Версия модели: `V6` (по умолчанию), `V6_MINI`, `V6_WILD`

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

Доступность ссылок

Suno должен иметь возможность скачать оба файла по переданным URL. Размещайте аудио на хостинге с публичным доступом и стабильным скачиванием (S3, собственный CDN, публичный bucket). Закрытые или требующие авторизации ссылки приведут к ошибке генерации.

Конкретный промпт

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

Custom Mode для контроля

Если нужен свой текст, конкретный стиль и название трека — включайте customMode: true и передавайте style, title и расширенный prompt. Без custom mode модель сама сформирует текст и подберёт стиль на основе исходных треков.

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

V6 — флагман по умолчанию. V6_MINI — быстрее и дешевле для экспериментов. V6_WILD — даёт более нестандартные сочетания, подходит для творческих поисков.

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

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

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

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

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

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

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

Когда статус completed, в ответе будут URL аудиофайла, обложка, название и длительность мэшапа.

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

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

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

Suno Music Generate

Генерация полноценной песни с вокалом и текстом

Suno Sounds

Звуковые эффекты, сэмплы и атмосферные фоны

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

Продвинутое

Классификация и оценка

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

Интеграции

Обзор

Возможности

Смешивание двух треков

Переработка текста

Custom Mode

Выбор версии

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

Простой мэшап

Custom Mode (свой текст, стиль, название)

Параметры

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

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

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

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

Suno Music Generate

Suno Sounds

​Обзор

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

Смешивание двух треков

Переработка текста

Custom Mode

Выбор версии

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

​Простой мэшап

​Custom Mode (свой текст, стиль, название)

​Параметры

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

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

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

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

Suno Music Generate

Suno Sounds

Обзор

Возможности

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

Простой мэшап

Custom Mode (свой текст, стиль, название)

Параметры

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

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

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