MiniMax Music API

ПровайдерMinimax

minimax-music-2-0 — генерация аудио-модель от Minimax.

Попробуйте прямо здесь

Что умеет MiniMax Music

Базовый набор возможностей модели — см. документацию вендора.

Стоимость

за запрос
6.6 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

Технические характеристики

Vendor
minimax
Modality
audio

MiniMax Music 3.0 — генерация песен и музыки с помощью ИИ

MiniMax Music 3.0 — музыкальная ИИ-модель китайской компании MiniMax, представленная 13 августа 2026 года. Она создает готовые композиции по идее и тексту: продумывает аранжировку, вокал и звучание трека длительностью до пяти минут. Гибридная архитектура Global–Local LLM помогает сохранять структуру песни, выразительность исполнения и детализацию инструментов.

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
lyrics
string
min: 1 · max: 3500
—
Лирика с тегами [Verse]/[Chorus]/[Bridge]/[Hook]/etc. Required для non-instrumental.
prompt
string
min: 1 · max: 2000
—
Описание музыки/жанр/стиль. Required если без lyrics.
is_instrumental
boolean
—
false
lyrics_optimizer
boolean
—
false
Авто-оптимизация лирики.
audio_setting
object
—
—
Параметры аудио-файла трека.
1 формата ввода
audio_setting config
ПолеТипЗначенияОписание
sample_rateenum16000, 24000, 32000, 44100Частота дискретизации Hz.
bitrateenum32000, 64000, 128000, 256000Битрейт bps.
formatenummp3, wav, flacАудио-формат.
{
  "sample_rate": 44100,
  "bitrate": 256000,
  "format": "mp3"
}
output_format
enum
url, hex
hex
audio_url
string
—
—
URL референс-аудио для cover.
audio_base64
string
—
—
Base64 референс-аудио для cover.
cover_feature_id
string
—
—
Feature ID для cover-режима.
stream
boolean
—
false

Параметры ответа

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}. Эта модель работает только в async-режиме.

Sync (HTTP 200)

Для TTS короткого input: HTTP 200, **binary audio** (Content-Type: audio/mpeg / audio/wav / ...). Это НЕ JSON — это байты файла.

Binary response. Content-Type: audio/mpeg, audio/wav, audio/opus, audio/ogg

Async (HTTP 202)

Если is_async_only=1 (music gen) или async:true в запросе. HTTP 202 + JSON.

ПолеТипЗначенияОписание
id
string
—
task_id для GET /v1/tasks/{id}.
object
string
audio.task
status
enum
queued, processing, completed, failed
model
string
—
created
integer
—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id}.

ПолеТипЗначенияОписание
id
string
—
status
enum
queued, processing, completed, failed, canceled
modality
string
audio
model
string
—
data
array
—
Каждый элемент:
  • url— string · CDN URL .mp3 / .wav. Для Suno music — 1-2 файла (варианты трека).
error
string
—

Пример кода

minimax-music-2-0_example.py
from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.audio.speech.create(
    model= "minimax-music-2-0",
    lyrics= "Текст песни",
    prompt= "Пример промпта",
    is_instrumental= False,
    lyrics_optimizer= False,
    audio_setting= {},
    output_format= "hex",
    audio_url= "https://example.com/...",
    audio_base64= "value",
    cover_feature_id= "value",
    stream= False,
)
print(resp)
Полная документация модели

Частые вопросы о MiniMax Music

MiniMax Music 3.0 — ИИ-модель для создания полноценных песен по текстовому описанию и словам: с вокалом, аранжировкой, инструментами и атмосферой.
Модель помогает быстро создавать демо, джинглы, музыкальные идеи и треки для роликов, игр или подкастов, превращая замысел и текст в готовую композицию.
Подключить модель удобно через Ranvik API: сервис дает единый ключ для работы с ИИ-инструментами, понятный личный кабинет и доступ из России без VPN.
Зарегистрируйтесь в Ranvik API, пополните баланс и получите ключ в кабинете. Сервис работает в России без VPN, поэтому запросы можно отправлять из кода напрямую.
Да, в Ranvik API доступно пополнение в рублях российскими способами оплаты. Вы оплачиваете фактическое использование и контролируете расходы в личном кабинете.
Обычно достаточно описать жанр, настроение, инструменты и сценарий звучания, а для песни добавить текст. Чем точнее промпт, тем управляемее результат генерации.