> ## Documentation Index
> Fetch the complete documentation index at: https://mulerouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax Music 2.5 Text to Music

> Create a music generation task using the music-2.5 model.

## Overview

Generate music from text descriptions and lyrics using the MiniMax Music 2.5 model. Music 2.5 is the latest version with improved quality:

* **Style description** — specify music style, mood, and scenario via `prompt`
* **Lyrics support** — provide song lyrics with `lyrics_prompt`
* **Structure tags** — organize songs with `[Intro]`, `[Verse]`, `[Chorus]`, `[Bridge]`, `[Outro]` tags
* **Up to 5 minutes** — generate songs up to 5 minutes long
* **Audio customization** — configurable format (MP3/PCM/FLAC), sample rate, and bitrate
* **Improved quality** — enhanced music generation compared to Music 2.0


## OpenAPI

````yaml api-reference/endpoint/minimax/music-2.5/music-2.5.yaml POST /vendors/minimax/v1/music-2.5/text-to-music/generation
openapi: 3.1.0
info:
  title: MiniMax Music 2.5 API
  description: MiniMax Music 2.5 - Music Generation from Lyrics and Style Description
  version: 2.0.0
servers:
  - url: https://api.mulerouter.ai/
security:
  - bearerAuth: []
paths:
  /vendors/minimax/v1/music-2.5/text-to-music/generation:
    post:
      summary: Create Music Generation Task
      description: Create a music generation task using the music-2.5 model.
      operationId: music_2_5_create
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MusicGenerationRequest'
            example:
              prompt: Acoustic, indie folk, gentle and reflective mood
              lyrics_prompt: |-
                [Intro]
                (Guitar strumming)

                [Verse]
                Sitting by the window
                Watching the rain fall down

                [Chorus]
                But I know tomorrow
                Will bring a brand new day
      responses:
        '202':
          description: Accepted - Task created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskCreatedResponse'
              example:
                task_info:
                  id: 8e1e315e-b50d-4334-a231-be7d19a372f4
                  status: pending
                  created_at: '2026-03-03T00:00:00Z'
                  updated_at: '2026-03-03T00:00:00Z'
components:
  schemas:
    MusicGenerationRequest:
      type: object
      required:
        - prompt
        - lyrics_prompt
      properties:
        prompt:
          type: string
          minLength: 10
          maxLength: 2000
          description: >-
            A description of the music, specifying style, mood, and scenario.
            10-2000 characters.
        lyrics_prompt:
          type: string
          minLength: 10
          maxLength: 3000
          description: >
            Lyrics of the song. Use \n to separate lines. You may add structure
            tags like [Intro], [Verse], [Chorus], [Bridge], [Outro] to enhance
            the arrangement. 10-3000 characters.
        audio_setting:
          anyOf:
            - $ref: '#/components/schemas/AudioSetting'
            - type: 'null'
          description: Audio configuration settings.
    TaskCreatedResponse:
      type: object
      properties:
        task_info:
          $ref: '#/components/schemas/TaskInfoCreated'
    AudioSetting:
      type: object
      properties:
        format:
          type: string
          enum:
            - mp3
            - pcm
            - flac
          default: mp3
          description: Audio format.
        sample_rate:
          type: integer
          enum:
            - 8000
            - 16000
            - 22050
            - 24000
            - 32000
            - 44100
          default: 44100
          description: Sample rate of generated audio (Hz).
        bitrate:
          type: integer
          enum:
            - 32000
            - 64000
            - 128000
            - 256000
          default: 256000
          description: Bitrate of generated audio (bps).
    TaskInfoCreated:
      type: object
      required:
        - id
        - status
        - created_at
        - updated_at
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - pending
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````