MiniMax Music

minimax-music-2-0

MiniMax Music — генерация аудио от MiniMax, доступная через единый Ranvik API.

от 14 ₽ / запрос

Карточка модели

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

МодальностьГенерация аудио

Провайдерminimax

СтатусАктивна

ID для запросовminimax-music-2-0

Цены

Единица	Цена
за запрос	14 ₽
за запрос	14 ₽

Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.

Поддерживаемые параметры

Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.

Параметр Тип Диапазон / values Default Описание

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_rate`	enum	16000, 24000, 32000, 44100	Частота дискретизации Hz.
`bitrate`	enum	32000, 64000, 128000, 256000	Битрейт bps.
`format`	enum	mp3, 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	—

Пример запроса

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)

Замените rk_live_... на ваш ключ из кабинета.

О провайдере: MiniMax

MiniMax — китайская AI-лаборатория. Известна моделями TTS высокого качества (Speech) с поддержкой многоязычной речи и клонирования голоса, а также видеогенератором Hailuo.

Официальный сайт: https://minimaxi.com

Документация модели у вендора: https://www.minimax.io/platform/document/api-reference