Skip to main content
POST

Аутентификация

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

Параметры запроса

string
обязательно
Название модели, всегда передавайте "flowmusic" (без учёта регистра)
string
обязательно
Версия модели, всегда передавайте "lyria-3.5"
Lyria 3.5 по-прежнему использует flowmusic в качестве названия модели. Не меняйте model на lyria-3.5 или flowmusic-lyria-3.5.
string
Промпт с описанием музыкального стиля или звучанияПример: "upbeat pop music with piano"
sound_prompt и lyrics не могут быть пустыми одновременно (передайте хотя бы один). За один запрос генерируется только одна композиция.
string
Текст песни; его можно предварительно получить через эндпоинт Генерация текста песни и подставить сюдаПример: "[Verse 1]\nКакой бы долгой ни была ночь, рассвет наступит\n..."
string
Название генерируемой композиции
string
BPM (ударов в минуту), должно быть ≥ 1Пример: "120"
integer
Длительность генерации (в секундах)Допустимый диапазон: от 1 до 240 секунд
string
Случайное зерно (seed) для воспроизведения результата
Передача одинакового значения seed при одинаковом запросе даёт похожий результат, но полная идентичность не гарантируется.

Ответ

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

Сценарии использования

Сценарий 1: генерация только по стилевому промпту

Сценарий 2: композиция из текста песни + стиля

Запрос результата задачиГенерация музыки — асинхронная задача; после отправки возвращается task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результата генерации.

Пример результата выполненной задачи

Пример ответа на запрос (GET /v1/music/tasks/{task_id}):