Генерация музыки и каверов

Синхронная генерация музыки или каверов с использованием музыкального протокола MiniMax.

Этот интерфейс генерирует музыку или кавер в рамках одного синхронного HTTP-запроса. Обычный запрос может возвращать временный URL аудио или аудиоданные Hex; потоковый запрос возвращает аудиофрагменты JSON построчно.

Для обработки потокового результата объединяйте содержимое Hex из data.audio в порядке получения, а после получения data.status=2 завершите декодирование и сохранение. Даже при HTTP-статусе 200 необходимо проверить base_resp.status_code: только значение 0 означает успешное выполнение операции.

POST/v1/music_generation

Синхронно генерирует музыку или кавер. При stream=true ответ возвращает аудиофрагменты JSON построчно в рамках того же HTTP-соединения; асинхронная задача не создаётся.

Поле data.audio в потоковом результате содержит аудиофрагмент Hex; фрагменты следует объединять в порядке получения. data.status=2 означает завершение генерации.

Потоковый ответ всегда возвращает аудиофрагменты Hex. При stream=true, даже если передать output_format=url, текущий шлюз может игнорировать это значение и вернуть поток Hex.

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

bearerAuth

АутентификацияBearer <token>

Используйте Bearer your-api-key в Header Authorization.

Расположение: header

Тело запроса

application/json

Параметры генерации музыки или кавера. Условная обязательность полей зависит от режима генерации.

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID музыкальной модели MiniMax, доступной текущему ключу API, например music-3.0, music-2.6 или music-cover.

prompt?string

Описание стиля, настроения и сцены. Обязательно в инструментальном режиме; в остальных режимах может быть опущено.

Длинаlength <= 2000

lyrics?string

Текст песни с разделением строк переносами. Обычно обязателен для песни с вокалом; при включённой оптимизации текста и пустом поле может генерироваться автоматически.

Длинаlength <= 3500

stream?boolean

Возвращать ли аудиофрагменты Hex в формате JSON построчно в текущем HTTP-ответе.

По умолчаниюfalse

output_format?string

Способ возврата аудио. Потоковый ответ всегда использует hex; даже при передаче url текущий шлюз может игнорировать это значение и возвращать фрагменты Hex. URL обычно истекает через 24 часа.

По умолчанию"hex"

Допустимые значения

"url"
"hex"

audio_setting?

lyrics_optimizer?boolean

Генерировать ли текст песни автоматически по Prompt, если поле текста песни пусто.

По умолчаниюfalse

is_instrumental?boolean

Генерировать ли инструментальную музыку без вокала. При true поле lyrics не требуется.

По умолчаниюfalse

audio_url?string

URL референсного аудио для кавера; взаимоисключается с audio_base64 и cover_feature_id.

Форматuri

audio_base64?string

Референсное аудио для кавера в Base64; взаимоисключается с audio_url и cover_feature_id.

cover_feature_id?string

ID признаков, возвращаемый предварительной обработкой кавера; действителен 24 часа. При его использовании необходимо предоставить текст песни длиной от 10 до 1000 символов.

aigc_watermark?boolean

Добавлять ли водяной знак AIGC в конце аудио; действует только для запросов без потоковой передачи.

По умолчаниюfalse

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/music_generation" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Нежное фортепиано и струнные, утренний рассвет, тёплое успокаивающее настроение, стиль музыки к фильму",    "is_instrumental": true,    "audio_setting": {      "sample_rate": 44100,      "bitrate": 256000,      "format": "mp3"    },    "output_format": "url",    "stream": false  }'

{
  "data": {
    "audio": "https://example.com/music/output.mp3",
    "status": 2
  },
  "trace_id": "04ede0ab069fb1ba8be5156a24b1e081",
  "extra_info": {
    "music_duration": 244262,
    "music_sample_rate": 44100,
    "music_channel": 2,
    "bitrate": 256000,
    "music_size": 7818388
  },
  "analysis_info": null,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Генерация музыки и каверов

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

Тело запроса

Тело ответа

200application/json

401application/json

`application/json`

`application/json`