MiniMax
MiniMax Music 3
minimax-music-3
Введите текст песни и описание музыки, чтобы сгенерировать стереофоническую песню длительностью до примерно 5 минут с вокалом и полной структурой музыкальной формы — подходит для быстрого создания демоверсий песен и индивидуального музыкального сопровождения
Попробовать minimax-music-3
Ввод
Работы
Все работыВывод
audioЦены
minimax-music-3 per second
| Цена за единицу | $0.0026 |
|---|
Общее описание
minimax-music-3 — это модель генерации музыки по тексту, выпущенная MiniMax и доступная через унифицированный интерфейс HiAPI.ai. Достаточно ввести текст песни и музыкальное описание, чтобы получить полноценную песню с вокалом и полной аранжировкой; поддерживаются такие структурные части, как вступление, куплет, припев, бридж и кода, а длительность одного фрагмента можно удерживать в пределах нескольких минут. Модель подходит разработчикам и контент-командам, которым нужно массово создавать демо песен, делать заказную фоновую музыку или превращать готовые тексты в аудио.
Ключевые особенности
- Двойное управление — текст и описание — в тексте песни по строкам расставляются теги частей, а в описании можно задать жанр, BPM, тональность и манеру исполнения; структура и стиль управляются отдельно.
- Полная музыкальная форма, а не фрагмент — результат содержит выстроенную композицию от вступления до коды вместе с вокалом и может сразу служить заготовкой готовой песни.
- Иерархическая архитектура для структуры и вокальных деталей — глобальный уровень отвечает за развёртывание длинной музыкальной формы, локальный — за покадровые акустические детали, что делает стыки частей длинного аудио устойчивее.
- Верхняя граница длительности в секундах — параметр duration поддерживает значения от 1 до 300 секунд; модель может завершить генерацию раньше, что позволяет подгонять вывод под длину материала.
Возможности
Структурированная генерация музыкальной формы: модель автоматически выстраивает вступление, куплет, предприпев, припев, бридж, инструментальную часть и коду; чтобы указать принадлежность к части, в тексте песни по строкам записываются теги, а строки без тегов отбрасываются, поэтому формат текста нужно подготовить заранее.
Условное управление музыкальными свойствами: в prompt можно описать жанр, BPM, тональность, развитие настроения, инструментовку и вокальные детали; чем конкретнее описание, тем точнее управление стилем, что подходит для массового творчества со стабильной стилевой направленностью.
Задание верхней границы длительности: duration задаёт в секундах верхний предел длины генерации, по умолчанию 60 секунд, диапазон от 1 до 300 секунд; модель может завершить раньше, что удобно для подгонки вывода под длину фрагмента видео или подкаста.
Воспроизводимая генерация: предусмотрен параметр seed; одинаковый ввод с фиксированным seed позволяет воспроизвести тот же результат, а при его отсутствии используется случайный seed — это удобно для сравнения разных описаний и управления версиями.
Фиксированные характеристики аудиовыхода: вывод — стерео WAV 32 кГц, 16 бит, который можно сразу отправлять в монтаж или сведение без дополнительного перекодирования.
Сценарии применения
- Быстрое создание демо песен музыкантами — ввод полного текста песни и описания стиля даёт заготовку готовой песни с вокалом и аранжировкой, чтобы показать направление команде или клиенту.
- Заказная музыка для видео- и игровых команд — генерация фоновой музыки по описанию BPM и настроения с длительностью под хронометраж и прямой вставкой в дорожку монтажа или игры.
- Превращение готовых текстов в песни — написанный текст размечается по частям и подаётся вместе с описанием стиля, превращаясь в версию исполнения для прослушивания.
- Массовый подбор по жанрам и настроениям — с фиксированным seed и несколькими наборами описаний сравниваются результаты разных жанров и тональностей, что позволяет быстро отбирать пригодный материал.
Ограничения и рекомендации по выбору
Точность воспроизведения не западных музыкальных стилей ограничена, и явно стилизованные подсказки могут отклониться от ожиданий; в карточке модели не заявлена способность петь на нескольких языках, поэтому тексты не на английском нужно сначала проверить на коротких образцах. Верхний предел одной генерации — около 5 минут, вывод всегда стерео WAV 32 кГц, 16 бит, другие частоты дискретизации или форматы кодирования не предусмотрены. Если нужны более длинные полноценные произведения или строгое многоязычное исполнение, сначала проверьте результат на коротких фрагментах, а затем решайте, использовать ли модель.
Новости
Смотреть changelog →- Новая модель Новая модель: minimax-music-3 — высококачественная генерация песен от MiniMax с управляемой длительностью. Текст песни обязателен…
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: minimax-music-3
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для minimax-music-3 и маршрута default — см. таблицу параметров ниже.
seedintegerНеобязательноСлучайное зерно для воспроизводимости результата; принимает целое число, при пропуске используется случайное зерно.
lyricsstringОбязательноТекст песни для исполнения; структурные теги, такие как [intro], [verse], [chorus] и т. д., должны занимать отдельную строку каждый, текст в одной строке с тегом будет отброшен.
promptstringОбязательноОписание музыки, задающее стиль, настроение, вокал, инструментовку и аранжировку; для точного управления может включать жанр, BPM, тональность, развитие настроения, детали вокала и пофрагментную аранжировку.
durationnumberНеобязательноПо умолчанию: 60min 1max 300Верхний предел длительности генерируемого аудио в секундах; модель может завершить раньше. По умолчанию 60 секунд.
callbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-music-3",
"input": {
"lyrics": "…",
"prompt": "…",
"duration": 60
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "minimax-music-3",
input: {
"lyrics": "…",
"prompt": "…",
"duration": 60
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "minimax-music-3",
"input": {
"lyrics": "…",
"prompt": "…",
"duration": 60
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
Похожие модели
Все модели →Тот же тип
-
Lyria 3.5 Google $0.090 /трек -
Mureka 9.5 Mureka $0.322 per request -
Mirelo SFX 2.0 Mirelo AI $0.021 /секунду -
ElevenLabs ElevenLabs $0.0029 /секунду -
Gemini 3.1 Flash TTS Google -- -
MiniMax Music 2.6 MiniMax $0.210 /трек -
Lyria 3 Pro Google $0.140 /трек -
MiniMax Music 1.5 MiniMax $0.070 /трек -
Qwen Audio 3.0 TTS Alibaba $0.030 /1 000 символов



