{ "error": { "message": "sound_prompt and lyrics cannot both be empty", "type": "invalid_request", "param": "", "code": "invalid_request" }}
{ "error": { "message": "Недостаточно средств на балансе", "type": "invalid_request", "param": "", "code": "quota_not_enough" }}
{ "error": { "message": "Текущая группа перегружена, повторите попытку позже", "type": "rate_limit_error", "param": "", "code": "rate_limit_error" }}
Аутентификация
string
обязательно
Все эндпоинты требуют аутентификации с помощью Bearer TokenПолучение API Key:Посетите страницу управления API Key, чтобы получить ваш API KeyДобавьте его в заголовок запроса:
Authorization: Bearer YOUR_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
Массив возвращаемых данных
Показать Элементы массива
string
Статус задачи, при первоначальной отправке — submitted
string
Уникальный идентификатор задачи, используется для запроса статуса и результата задачи
Сценарии использования
Сценарий 1: генерация только по стилевому промпту
{ "model": "flowmusic", "version": "lyria-3.5", "title": "My Song", "sound_prompt": "upbeat pop music with piano", "bpm": "120", "length": 60}
Сценарий 2: композиция из текста песни + стиля
{ "model": "flowmusic", "version": "lyria-3.5", "title": "Настойчивость", "lyrics": "[Verse 1]\nКакой бы долгой ни была ночь, рассвет наступит\n...", "sound_prompt": "energetic rock with electric guitar", "length": 120}
Запрос результата задачиГенерация музыки — асинхронная задача; после отправки возвращается task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результата генерации.
Пример результата выполненной задачи
Пример ответа на запрос (GET /v1/music/tasks/{task_id}):