Перейти к основному содержанию
POST
Этот эндпоинт не имеет измерения версии: не передавайте version — если параметр передан, он отбрасывается и не влияет на тарификацию.
Известное ограничение: не загружайте чисто инструментальное (без вокала) аудио — вышестоящий сервис может не суметь его разобрать (parse).

Authorizations

Authorization
string
обязательно
Все эндпоинты требуют аутентификации с использованием Bearer TokenПолучить API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyПри использовании добавьте в заголовки запроса:

Body

model
string
по умолчанию:"suno"
Аудиомодель. Сейчас передавайте suno (если не указано, по умолчанию suno).
audioFilePath
string
обязательно
Публично доступная прямая ссылка на аудио. Если отсутствует, на этапе отправки сразу возвращается 400 (без обращения к вышестоящему сервису и без списания средств).
Получение результата: этот эндпоинт является асинхронной задачей. После отправки вы получаете task_id; опрашивайте GET /v1/music/tasks/{task_id} с интервалом 3–5 с, пока status не станет completed или failed (во время генерации status равен pending, а progress меняется: в очереди 10 → готово 50 → завершено 100). После завершения используйте task_id этой задачи + audio_index=1 как источник для других операций. При неудаче data.error.message содержит причину, а предварительно списанная квота автоматически возвращается.

Response

code
integer
Код статуса ответа
data
array
Массив возвращаемых данных