Обзор

Документация Suno API

Основная информация

Адреса API

• По умолчанию:

  https://{BASE_URL}/suno/submit/music
  https://{BASE_URL}/suno/fetch

Поддержка моделей

Поддерживаемые модели

• chirp-v3-0 (версия v3.0)
• chirp-v3-5 (версия v3.5)
• chirp-v4 (версия v4.0)
• chirp-auk (версия v4.5)
• chirp-v5 (версия v5.0)

Уведомления обратного вызова

• Поддерживается URL обратного вызова notify_hook
• Требования:
  • Метод: POST
  • Данные: структура задачи (task)

Шаги использования

1. Создать задачу Suno

2. Запросить прогресс задачи

Структуры данных

Объект Task

Поле	Тип	Пример	Описание
task_id	string	f4a94d75-087b-4bb1-bd45-53ba293faf96	ID задачи
action	string	MUSIC	Тип задачи: MUSIC (генерация песни), LYRICS (генерация текста)
status	string	SUCCESS	Статус: NOT_START (не запущена), SUBMITTED (отправлена), QUEUED (в очереди), IN_PROGRESS (выполняется), FAILURE (ошибка), SUCCESS (успех)
submitTime	number	1689231405854	Время отправки
startTime	number	1689231442755	Время начала
finishTime	number	1689231544312	Время завершения
failReason	string	[Invalid parameter] Invalid value	Причина сбоя (при FAILURE)
data	object	-	Данные: музыка (массив) или текст (один объект)

Продолжение музыки

• Необходимо передать параметр task_id для указания задачи