Skip to main content
SUNO позволяет создавать пользовательские голосовые персонажи на основе любых аудиофайлов, реализуя клонирование голоса для генерации музыки. В отличие от существующего Persona API (использующего audio_id, сгенерированный Suno), этот API принимает общедоступный audio_url — вашу собственную запись голоса. В этом документе описывается метод интеграции API клонирования голоса.

Шаг 1: Создание голосового персонажа

API принимает три входных параметра: audio_url (обязательный) — URL общедоступного аудиофайла в формате MP3 или WAV с чистым голосом одного человека; name и description (необязательные) — имя и описание голосового персонажа. Требования к аудиофайлу:
  • Формат: MP3 или WAV
  • Длительность: не менее 10 секунд
  • Содержание: чистый голос одного человека, минимальный уровень фонового шума или музыки
Результат:
Как видно, поле persona_id в data — это ID созданного голосового персонажа. Поле is_public всегда false, так как голосовые персонажи, созданные загрузкой аудио, являются приватными.

Шаг 2: Генерация музыки с использованием голосового персонажа

После получения ID голосового персонажа можно использовать Suno Audios Generation API для генерации музыки. Установите action в generate, а persona_id — в ID созданного голосового персонажа. Сгенерированная песня будет исполнена клонированным голосом.
Внимание: Клонирование голоса поддерживается только моделями chirp-v4-5 и выше (например, chirp-v4-5, chirp-v5, chirp-v5-5), не поддерживается моделью chirp-v4.
Результат:
Как видно, сгенерированная песня исполнена клонированным голосом. persona_id также можно использовать с действием cover для исполнения каверов существующих песен клонированным голосом.