MiniMax: Music 2.5
MiniMax Music 2.5 convierte una letra y un encargo musical en audio generado mediante una solicitud síncrona de música. Esta edición exacta permite un prompt vacío, acepta de 1 a 3500 caracteres de letra y ofrece salida MP3 o WAV.
- Ailoot Ultra · Music
POST /v1/music/generationsminimax/music-2.5 - Ailoot Ultra · Music
POST /v1/music/generationsmusic-2.5
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
MiniMax Music 2.5 crea música a partir de un encargo musical escrito y una letra. Selecciona minimax/music-2.5 para esta edición exacta; music-2.5 es su alias configurado. Su método de música utiliza una solicitud JSON con model, prompt y lyrics y produce audio generado. Utilízalo para convertir un concepto escrito de canción en un borrador que escuchar, poner música a una letra proporcionada o explorar una composición antes de seguir editándola.
Utiliza prompt para describir el estilo musical, el ambiente y el entorno, y lyrics para las palabras que deben cantarse. Un encargo útil podría pedir una canción folk introspectiva para una cafetería tranquila, con una estrofa que establezca la escena y un estribillo que repita su idea central. Mantén la dirección musical en prompt y los versos previstos en lyrics para que el texto tenga una función clara en la composición.
Esta edición permite un prompt de 0 a 2000 caracteres y lyrics de 1 a 3500 caracteres. La solicitud configurada incluye el campo prompt incluso cuando su valor está vacío, porque el esquema sigue enumerando prompt entre los campos obligatorios. Para una composición dirigida, utiliza ese campo para indicar el género, la emoción y el entorno; un valor vacío deja sin especificar esas indicaciones escritas. Mantén el texto completo de la letra dentro de su propio límite.
Separa los versos con caracteres de salto de línea. Las etiquetas de sección, como [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge] y [Outro], pueden identificar la estructura prevista; el conjunto documentado también incluye [Interlude], [Post Chorus], [Transition], [Break], [Hook], [Build Up], [Inst] y [Solo]. Coloca las palabras reales debajo de sus etiquetas de sección y haz que las secciones repetidas sean deliberadas. Estos marcadores aportan a la composición una estructura de partida; revisa cómo realiza realmente la canción completada las transiciones y las repeticiones.
El objeto audio_setting ofrece valores de sample_rate de 16000, 24000, 32000 o 44100, valores de bitrate de 32000, 64000, 128000 o 256000, y valores de format mp3 o wav. Elige los ajustes del archivo para el siguiente paso de edición o reproducción y consérvalos junto con el encargo. El ejemplo publicado solicita 44100, 256000 y mp3; son selecciones del ejemplo en lugar de valores predeterminados universales para los tres campos.
El flujo de trabajo de música seleccionado es síncrono y sin streaming. Las opciones documentadas de output_format son url y hex, con hex como valor predeterminado del esquema; el ejemplo seleccionado solicita explícitamente url. Para la salida URL, utiliza el enlace de Ailoot devuelto para descargar el audio guardado. Un resultado hex representa bytes de audio que deben decodificarse al formato de archivo seleccionado antes de reproducirlos. La respuesta puede contener las ubicaciones audio y audio_url para un único audio generado; conserva ese resultado como una sola canción.
Guarda el audio completado con su letra, el encargo musical, el ID exacto del modelo y los ajustes de archivo solicitados. Escucha las palabras previstas, el orden de las secciones y la dirección musical antes de incorporarlo a un proyecto. Si una solicitud termina sin un resultado completo, conserva la identidad de su solicitud original y la información de la respuesta para comprobar el resultado; una solicitud de sustitución automática puede crear otra canción. Una revisión puede modificar un verso o una instrucción musical específicos manteniendo el resto del encargo para comparar.
Ailoot Ultra · Music POST /v1/music/generations minimax/music-2.5
minimax/music-2.5minimax/music-2.5music-2.5
Inicio
MiniMax Music 2.5 convierte una letra y un encargo musical en audio generado mediante una solicitud síncrona de música. Esta edición exacta permite un prompt vacío, acepta de 1 a 3500 caracteres de letra y ofrece salida MP3 o WAV.
- Entradas aceptadas
- Texto
- Resultados
- Audio
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Music POST /v1/music/generations
- Entrada
text- Salida
audio- Formato de salida
- mp3,wav
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites minimax/music-2.5 | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campolyrics | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites false | Predeterminadofalse |
Campooutput_format | Tipostring | RequisitoOpcional | Valores y límites url, hex | Predeterminadohex |
Campoaudio_setting | Tipoobject | RequisitoOpcional | Valores y límites | Predeterminado— |
Campoaudio_setting.sample_rate | Tipointeger | RequisitoOpcional | Valores y límites 16,000, 24,000, 32,000, 44,100 | Predeterminado— |
Campoaudio_setting.bitrate | Tipointeger | RequisitoOpcional | Valores y límites 32,000, 64,000, 128,000, 256,000 | Predeterminado— |
Campoaudio_setting.format | Tipostring | RequisitoOpcional | Valores y límites mp3, wav | Predeterminado— |
Campoaigc_watermark | Tipoboolean | RequisitoOpcional | Valores y límites | Predeterminadofalse |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt, lyrics |
Parámetrooptional | Contratostream, output_format, audio_setting, aigc_watermark |
Parámetromaterial_types | Contratotext |
Parámetroconditions | ContratoUse a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifas
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo fast
- Sin especificar Cuando se selecciona el modo fast
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default
Tarifas de Ailoot
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad para facturación | Cargo |
|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad para facturación— | Cargo Entrada · Tokens de entrada — / 1K tokens Salida · Tokens de salida — / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
| ConfiguraciónPor solicitud | Tabla de tarifas— | Cantidad para facturaciónuna solicitud | Cargo Entrada $0.3 por solicitud |
Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
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.
Recibir y guardar resultados
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
Si es necesario revisar la respuesta original
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campodata.audio | Tipostring |
Campodata.audio_url | Tipostring |
Campodata.status | Tipointeger |
Alias
Alias del modelo
Ailoot Ultra minimax/music-2.5, music-2.5
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
Ailoot Ultra · Music POST /v1/music/generations music-2.5
music-2.5minimax/music-2.5music-2.5
Inicio
MiniMax Music 2.5 convierte una letra y un encargo musical en audio generado mediante una solicitud síncrona de música. Esta edición exacta permite un prompt vacío, acepta de 1 a 3500 caracteres de letra y ofrece salida MP3 o WAV.
- Entradas aceptadas
- Texto
- Resultados
- Audio
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Music POST /v1/music/generations
- Entrada
text- Salida
audio- Formato de salida
- mp3,wav
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites music-2.5 | Predeterminado— |
Campoprompt | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campolyrics | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campostream | Tipoboolean | RequisitoOpcional | Valores y límites false | Predeterminadofalse |
Campooutput_format | Tipostring | RequisitoOpcional | Valores y límites url, hex | Predeterminadohex |
Campoaudio_setting | Tipoobject | RequisitoOpcional | Valores y límites | Predeterminado— |
Campoaudio_setting.sample_rate | Tipointeger | RequisitoOpcional | Valores y límites 16,000, 24,000, 32,000, 44,100 | Predeterminado— |
Campoaudio_setting.bitrate | Tipointeger | RequisitoOpcional | Valores y límites 32,000, 64,000, 128,000, 256,000 | Predeterminado— |
Campoaudio_setting.format | Tipostring | RequisitoOpcional | Valores y límites mp3, wav | Predeterminado— |
Campoaigc_watermark | Tipoboolean | RequisitoOpcional | Valores y límites | Predeterminadofalse |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, prompt, lyrics |
Parámetrooptional | Contratostream, output_format, audio_setting, aigc_watermark |
Parámetromaterial_types | Contratotext |
Parámetroconditions | ContratoUse a nonstreaming request. MP3 and WAV are available; a PCM control is absent from this method. |
Ciclo de vida: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifas
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo fast
- Sin especificar Cuando se selecciona el modo fast
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default
Tarifas de Ailoot
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Cantidad para facturación | Cargo |
|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad para facturación— | Cargo Entrada · Tokens de entrada — / 1K tokens Salida · Tokens de salida — / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
| ConfiguraciónPor solicitud | Tabla de tarifas— | Cantidad para facturaciónuna solicitud | Cargo Entrada $0.3 por solicitud |
Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
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.
Recibir y guardar resultados
Ailoot Ultra · Music
mp3,wav
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
One generated audio; retain every returned field. audio and audio_url are representations of the same output, not separate songs.
Si es necesario revisar la respuesta original
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Campos de respuesta
| Campo | Tipo |
|---|---|
Campodata.audio | Tipostring |
Campodata.audio_url | Tipostring |
Campodata.status | Tipointeger |
Alias
Alias del modelo
Ailoot Ultra minimax/music-2.5, music-2.5
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · MiniMax: Music 2.5
- ¿Qué entradas y resultados están disponibles?
POST /v1/music/generations·minimax/music-2.5:text→audioPOST /v1/music/generations·music-2.5:text→audio- ¿Qué campos utiliza la solicitud?
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