MiniMax: Music 2.5+
MiniMax Music 2.5+ генерирует музыку по запросу со стилем и настроением и предоставленному тексту песни. Её синхронный музыкальный профиль принимает 10–2 000 символов запроса, 10–3 500 символов текста песни и выводит MP3 или WAV.
- Ailoot Ultra · Music
POST /v1/music/generationsminimax/music-2.5+ - Ailoot Ultra · Music
POST /v1/music/generationsmusic-2.5+
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
MiniMax Music 2.5+ создаёт музыку по текстовому музыкальному заданию и тексту песни. Выберите minimax/music-2.5+ для этой конкретной редакции; music-2.5+ — её настроенный псевдоним. Музыкальный метод использует запрос JSON с model, prompt и lyrics и выдаёт сгенерированный звук. Используйте его, чтобы превратить текстовую концепцию песни в черновик для прослушивания, положить предоставленный текст на музыку или исследовать композицию перед дальнейшим редактированием.
Используйте prompt для описания музыкального стиля, настроения и обстановки, а lyrics — для слов, которые должны звучать в песне. Полезное задание может предусматривать задумчивую фолк-песню для тихого кафе, с куплетом, задающим сцену, и припевом, повторяющим её главную мысль. Держите музыкальное направление в prompt, а нужные строки — в lyrics, чтобы текст имел ясную роль в композиции.
Для Music 2.5+ prompt должен содержать 10–2 000 символов, а lyrics — 10–3 500 символов. Включите оба текстовых поля в запрос вместе с выбранной моделью. Используйте место в prompt для важных музыкальных решений, затем приведите полный нужный текст в lyrics. Компактное, но полное задание легче сравнивать с возвращённой песней, чем несвязанные инструкции, распределённые между обоими полями.
Разделяйте строки песни символами переноса строки. Метки разделов, такие как [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge] и [Outro], могут обозначать нужную структуру; документированный набор также включает [Interlude], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst] и [Solo]. Поместите фактические слова под метками их разделов и осознанно задавайте повторяющиеся разделы. Эти маркеры дают композиции структуру для работы; проверьте, как готовая песня на деле реализует переходы и повторы.
Объект audio_setting предлагает значения sample_rate 16000, 24000, 32000 или 44100, значения bitrate 32000, 64000, 128000 или 256000 и значения format mp3 или wav. Выберите настройки файла для следующего шага редактирования или воспроизведения и храните их вместе с заданием. Опубликованный пример запрашивает 44100, 256000 и mp3; это выбор значений в примере, а не универсальные значения по умолчанию для всех трёх полей.
Выбранный музыкальный процесс синхронен и не использует потоковую передачу. Документированные варианты output_format — url и hex; значение по умолчанию в схеме — hex, а выбранный пример явно запрашивает url. Для вывода URL используйте возвращённую ссылку Ailoot, чтобы загрузить сохранённый звук. Результат hex представляет аудиобайты, которые перед воспроизведением необходимо декодировать в выбранный формат файла. Ответ может содержать и audio, и audio_url для одного сгенерированного аудио; сохраняйте этот результат как одну песню.
Сохраните готовый звук вместе с текстом песни, музыкальным заданием, точным ID модели и запрошенными настройками файла. Прослушайте запись и проверьте текст песни, порядок разделов и музыкальное направление перед добавлением в проект. Если запрос закончился без полного результата, сохраните идентификатор исходного запроса и сведения об ответе для проверки результата; автоматический заменяющий запрос может создать ещё одну песню. Правка может менять конкретную строку песни или музыкальную инструкцию, сохраняя остальное задание для сравнения.
Ailoot Ultra · Music POST /v1/music/generations minimax/music-2.5+
minimax/music-2.5+minimax/music-2.5+music-2.5+
Начало
MiniMax Music 2.5+ генерирует музыку по запросу со стилем и настроением и предоставленному тексту песни. Её синхронный музыкальный профиль принимает 10–2 000 символов запроса, 10–3 500 символов текста песни и выводит MP3 или WAV.
- Допустимые входные данные
- Текст
- Результаты
- Аудио
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Music POST /v1/music/generations
- Входные данные
text- Результат
audio- Выходной формат
- mp3,wav
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения minimax/music-2.5+ | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеlyrics | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения false | По умолчаниюfalse |
Полеoutput_format | Типstring | ТребованиеНеобязательно | Значения и ограничения url, hex | По умолчаниюhex |
Полеaudio_setting | Типobject | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеaudio_setting.sample_rate | Типinteger | ТребованиеНеобязательно | Значения и ограничения 16 000, 24 000, 32 000, 44 100 | По умолчанию— |
Полеaudio_setting.bitrate | Типinteger | ТребованиеНеобязательно | Значения и ограничения 32 000, 64 000, 128 000, 256 000 | По умолчанию— |
Полеaudio_setting.format | Типstring | ТребованиеНеобязательно | Значения и ограничения mp3, wav | По умолчанию— |
Полеaigc_watermark | Типboolean | ТребованиеНеобязательно | Значения и ограничения | По умолчаниюfalse |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt, lyrics |
Параметрoptional | Контрактstream, output_format, audio_setting, aigc_watermark |
Параметрmaterial_types | Контрактtext |
Параметрconditions | КонтрактUse a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифы
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Ставки Ailoot
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Расчётное количество | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Расчётное количество— | Плата Вход · Входные токены — / 1K токенов Выход · Выходные токены — / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| КонфигурацияЗа запрос | Шкала ставок— | Расчётное количествоОдин запрос | Плата Вход $0.3 за запрос |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "minimax/music-2.5+", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Получить и сохранить результаты
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты
Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
Если нужно проверить исходный ответ
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Поля ответа
| Поле | Тип |
|---|---|
Полеdata.audio | Типstring |
Полеdata.audio_url | Типstring |
Полеdata.status | Типinteger |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra minimax/music-2.5+, music-2.5+
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
Ailoot Ultra · Music POST /v1/music/generations music-2.5+
music-2.5+minimax/music-2.5+music-2.5+
Начало
MiniMax Music 2.5+ генерирует музыку по запросу со стилем и настроением и предоставленному тексту песни. Её синхронный музыкальный профиль принимает 10–2 000 символов запроса, 10–3 500 символов текста песни и выводит MP3 или WAV.
- Допустимые входные данные
- Текст
- Результаты
- Аудио
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Music POST /v1/music/generations
- Входные данные
text- Результат
audio- Выходной формат
- mp3,wav
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения music-2.5+ | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеlyrics | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения false | По умолчаниюfalse |
Полеoutput_format | Типstring | ТребованиеНеобязательно | Значения и ограничения url, hex | По умолчаниюhex |
Полеaudio_setting | Типobject | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеaudio_setting.sample_rate | Типinteger | ТребованиеНеобязательно | Значения и ограничения 16 000, 24 000, 32 000, 44 100 | По умолчанию— |
Полеaudio_setting.bitrate | Типinteger | ТребованиеНеобязательно | Значения и ограничения 32 000, 64 000, 128 000, 256 000 | По умолчанию— |
Полеaudio_setting.format | Типstring | ТребованиеНеобязательно | Значения и ограничения mp3, wav | По умолчанию— |
Полеaigc_watermark | Типboolean | ТребованиеНеобязательно | Значения и ограничения | По умолчаниюfalse |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt, lyrics |
Параметрoptional | Контрактstream, output_format, audio_setting, aigc_watermark |
Параметрmaterial_types | Контрактtext |
Параметрconditions | КонтрактUse a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифы
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Ставки Ailoot
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Расчётное количество | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Расчётное количество— | Плата Вход · Входные токены — / 1K токенов Выход · Выходные токены — / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| КонфигурацияЗа запрос | Шкала ставок— | Расчётное количествоОдин запрос | Плата Вход $0.3 за запрос |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Music
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "music-2.5+", "prompt": "独立民谣,忧郁,内省,渴望,独自漫步,咖啡馆", "lyrics": "[verse]\\n街灯微亮晚风轻抚\\n影子拉长独自漫步\\n旧外套裹着深深忧郁\\n不知去向渴望何处\\n[chorus]\\n推开木门香气弥漫\\n熟悉的角落陌生人看", "audio_setting": {"sample_rate": 44100, "bitrate": 256000, "format": "mp3"}, "output_format": "url"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Получить и сохранить результаты
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты
Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
Если нужно проверить исходный ответ
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Поля ответа
| Поле | Тип |
|---|---|
Полеdata.audio | Типstring |
Полеdata.audio_url | Типstring |
Полеdata.status | Типinteger |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra minimax/music-2.5+, music-2.5+
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · MiniMax: Music 2.5+
- Какие входные данные и результаты доступны?
POST /v1/music/generations·minimax/music-2.5+:text→audioPOST /v1/music/generations·music-2.5+:text→audio- Какие поля использует запрос?
POST /v1/music/generations·minimax/music-2.5+:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermarkPOST /v1/music/generations·music-2.5+:model,prompt,lyrics,stream,output_format,audio_setting,aigc_watermark