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

# Music generation

> MiniMax official music generation (sync-style JSON response).

**Path:** `POST https://api.omniall.ai/v1/music_generation`

Provide `prompt` and/or `lyrics`. Optional `is_instrumental` for instrumental tracks.

Auth: `Authorization: Bearer sk-...`



## OpenAPI

````yaml openapi/minimax-music.yaml POST /v1/music_generation
openapi: 3.1.0
info:
  title: Omniall AI — MiniMax music
  version: 1.0.0
  description: >-
    MiniMax official music generation.


    **Path:** `POST https://api.omniall.ai/v1/music_generation`


    Model ids from the [Model Square](https://omniall.ai/pricing) (e.g. MiniMax
    music models).


    Auth: `Authorization: Bearer sk-...`
servers:
  - url: https://api.omniall.ai
security: []
paths:
  /v1/music_generation:
    post:
      tags:
        - MiniMax audio
      summary: Music generation
      description: >-
        MiniMax official music generation (sync-style JSON response).


        **Path:** `POST https://api.omniall.ai/v1/music_generation`


        Provide `prompt` and/or `lyrics`. Optional `is_instrumental` for
        instrumental tracks.


        Auth: `Authorization: Bearer sk-...`
      operationId: minimaxCreateMusic
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
            example: Bearer sk-...
          description: Bearer API key, e.g. `Bearer sk-...`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
              description: MiniMax music_generation body.
              properties:
                model:
                  type: string
                  description: Music model id from the Model Square.
                  example: music-2.0
                prompt:
                  type: string
                  description: Style / mood / arrangement description.
                  example: Upbeat indie pop with bright guitars and a hopeful chorus
                lyrics:
                  type: string
                  description: Optional lyrics text.
                  example: |-
                    [Verse]
                    City lights on wet asphalt
                    [Chorus]
                    We keep walking through the neon rain
                stream:
                  type: boolean
                  description: Whether to stream (if supported by upstream).
                  example: false
                output_format:
                  type: string
                  description: Output packaging, e.g. `url` / `hex` (upstream-dependent).
                audio_setting:
                  type: object
                  description: Audio encode settings.
                  properties:
                    sample_rate:
                      type: integer
                      example: 44100
                    bitrate:
                      type: integer
                      example: 256000
                    format:
                      type: string
                      example: mp3
                aigc_watermark:
                  type: boolean
                  description: AIGC watermark.
                lyrics_optimizer:
                  type: boolean
                  description: Optimize lyrics before generation.
                is_instrumental:
                  type: boolean
                  description: Instrumental only.
                  example: false
            examples:
              prompt_only:
                summary: Style prompt
                value:
                  model: music-2.0
                  prompt: Upbeat indie pop with bright guitars and a hopeful chorus
                  is_instrumental: false
              with_lyrics:
                summary: Prompt + lyrics
                value:
                  model: music-2.0
                  prompt: Cinematic indie pop, atmospheric neon night
                  lyrics: |-
                    [Verse]
                    City lights on wet asphalt
                    [Chorus]
                    We keep walking through the neon rain
                  audio_setting:
                    sample_rate: 44100
                    bitrate: 256000
                    format: mp3
              instrumental:
                summary: Instrumental
                value:
                  model: music-2.0
                  prompt: Soft ambient piano for late-night coding
                  is_instrumental: true
      responses:
        '200':
          description: >-
            Music generation result (provider JSON; often includes audio URL /
            hex)
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Upstream MiniMax response (includes `base_resp` and audio
                  fields).
              example:
                data:
                  audio: https://cdn.example.com/track.mp3
                  status: success
                base_resp:
                  status_code: 0
                  status_msg: success

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.