Flow Music
Генерация музыки
Flow Music — генерация музыки из текста. Поддержка стилевых промптов / текста песни / BPM / контроля длительности, за один запрос генерируется одна композиция
POST
Аутентификация
Все эндпоинты требуют аутентификации с помощью Bearer TokenПолучение API Key:Посетите страницу управления API Key, чтобы получить ваш API KeyДобавьте его в заголовок запроса:
Параметры запроса
Название модели, всегда передавайте
"flowmusic" (без учёта регистра)Промпт с описанием музыкального стиля или звучанияПример:
"upbeat pop music with piano"sound_prompt и lyrics не могут быть пустыми одновременно (передайте хотя бы один). За один запрос генерируется только одна композиция.Текст песни; его можно предварительно получить через эндпоинт Генерация текста песни и подставить сюдаПример:
"[Verse 1]\nКакой бы долгой ни была ночь, рассвет наступит\n..."Название генерируемой композиции
BPM (ударов в минуту), должно быть ≥ 1Пример:
"120"Длительность генерации (в секундах)Допустимый диапазон: от
1 до 240 секундСлучайное зерно (seed) для воспроизведения результата
Передача одинакового значения seed при одинаковом запросе даёт похожий результат, но полная идентичность не гарантируется.
Ответ
Код статуса ответа, 200 при успехе
Массив возвращаемых данных
Сценарии использования
Сценарий 1: генерация только по стилевому промпту
Сценарий 2: композиция из текста песни + стиля
Запрос результата задачиГенерация музыки — асинхронная задача; после отправки возвращается
task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результата генерации.Пример результата выполненной задачи
Пример ответа на запрос (GET /v1/music/tasks/{task_id}):