{ "error": { "message": "strength must be between 0 and 1", "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
обязательно
Уникальный идентификатор исходной композиции, из result.music[].clip_id успешно завершённой задачи
string
обязательно
Инструкция редактирования для CoverПример: "Переаранжировать эту песню в джазовом стиле"
number
обязательно
Сила редактированияДиапазон значений: от 0 до 1; чем больше, тем сильнее изменения
string
Название композиции после Cover
string
Случайное зерно (seed) для воспроизведения результата
Ответ
integer
Код статуса ответа, 200 при успехе
array
Массив возвращаемых данных
Показать Элементы массива
string
Статус задачи, при первоначальной отправке — submitted
string
Уникальный идентификатор задачи, используется для запроса статуса и результата задачи
Сценарии использования
Сценарий 1: переаранжировать всю композицию в джазовом стиле
{ "model": "flowmusic", "version": "lyria-3.5", "clip_id": "abc123-def456", "instruction": "Переаранжировать эту песню в джазовом стиле", "strength": 0.5}
Сценарий 2: аранжировка после импорта внешнего аудио
Сначала импортируйте внешнее аудио через Загрузку аудио, чтобы получить clip_id, затем выполните Cover:
Запрос результата задачиCover-аранжировка — асинхронная задача; после отправки возвращается task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результата генерации. Результат Cover — новыйclip_id; для последующих операций используйте новый clip_id.
Пример результата выполненной задачи
Пример ответа на запрос (GET /v1/music/tasks/{task_id}):