MiniMax Music 3.0 API

MiniMax Music 3.0 в SpicyAPI — это задача text-to-music, которая за один запрос возвращает одну законченную песню: основной вокал, аранжировку и финальное сведение в одном стерео-MP3. Вы отправляете описание стиля в prompt и, если они есть, слова для пения в lyrics; мелодию, аранжировку и исполнение берёт на себя модель. В наших тестах песни получались от 1:09 до 3:58, а каждая стоит одинаково — фиксированную цену за песню.

Целая песня, а не луп

На выходе — структурированная песня со вступлением, куплетами, возвращающимся припевом и концовкой, а не короткий повторяющийся фрагмент. Длину модель выбирает сама, в основном по объёму вашего текста, и сводит вокал с аккомпанементом в один готовый стерео-файл, который сразу можно слушать.

Три способа работы со словами

Можно спеть свой текст, поручить модели написать слова или обойтись без певца. Тексты, которые вы передали, исполняются как написаны, а теги секций вроде [Verse] и [Chorus] направляют аранжировку. Если lyrics пуст, generate_lyrics (включён по умолчанию) пишет полный текст песни по prompt. С включённым instrumental в треке нет вокала вообще.

Фиксированная цена и настраиваемое качество файла

Длина, bitrate и sample_rate не влияют на стоимость песни. Выбирайте 256 kbps при 44.1 kHz для мастера или более низкий битрейт для лёгких файлов предпросмотра.

Песни вокруг вашего текста

Сначала напишите текст, расставьте теги секций и опишите жанр и голос, которые слышите в голове. Подходит для персональных песен, тем персонажей для историй и игр, пародий и черновых демо текста, который хочется услышать вживую, прежде чем двигаться дальше.

Музыка для видео и стримов

Включите instrumental для подложек, лаунж-фонов и заставок или оставьте вокал для титульной песни. Трек длиной от одной до четырёх минут закрывает большинство коротких видео за один запрос, а фиксированная цена позволяет без лишних затрат сделать несколько дублей и выбрать лучший.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/music-3.0/text-to-audio",
  "input": {
    "prompt": "Calm ambient pads with a slow rising motif",
    "bitrate": 256000,
    "sample_rate": 44100
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.