> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax Music 2.6 > Generate songs and instrumental tracks from style prompts, with custom lyrics, automatic lyric generation and configurable audio output. 1. Submit the request with `VIDGO_API_KEY` and save the returned `task_id`. 2. Use [Query Task Status](/api-manual/task-management/status) to retrieve the audio. With a `callback_url`, Vidgo sends a notification to your [webhook](/api-manual/task-management/webhooks) when the task reaches `finished` or `failed`. # MiniMax Music 2.6 Create complete songs and instrumental tracks from a style prompt. Describe genre, mood, instrumentation, tempo and vocal direction to guide the music. ## Model Set `model` to `minimax/music-2.6`. Place music parameters inside `input` and the optional `callback_url` at the request root. ## Music Parameters * `prompt`: Required string of **10-2000 characters** describing the musical direction. * `lyrics`: Lyrics string of up to **3500 characters**. Supply lyrics when `is_instrumental` and `lyrics_optimizer` are both `false`. You can organize the words with section tags such as `[Verse]` and `[Chorus]`. * `lyrics_optimizer`: Boolean, default `false`. When `true` and `lyrics` is empty, generates lyrics from `prompt`. * `is_instrumental`: Boolean, default `false`. Set `true` for instrumental music, keep `lyrics` empty and set `lyrics_optimizer` to `false`. ## Creation Modes ### Custom Lyrics Write the musical direction in `prompt` and the words to sing in `lyrics`. Keep `is_instrumental` set to `false`. ### Automatic Lyrics Describe the musical style, song topic and vocal character in `prompt`. Set `lyrics_optimizer` to `true`, keep `lyrics` empty and set `is_instrumental` to `false`. ### Instrumental Music Describe instruments, rhythm and atmosphere in `prompt`. Set `is_instrumental` to `true`, keep `lyrics` empty and set `lyrics_optimizer` to `false`. ## Audio Settings `audio_setting` is an optional object with these fields: * `sample_rate`: Sample rate in Hz. Values: `16000`, `24000`, `32000`, `44100`. Default: `44100`. * `bitrate`: Bitrate in bits per second. Values: `32000`, `64000`, `128000`, `256000`. Default: `256000`. * `format`: Audio format. Values: `mp3`, `wav`, `pcm`. Default: `mp3`. ## Retrieve the Audio Query `GET /api/generate/status/{task_id}` using the identifier from the submission response. Continue checking while the status is `not_started` or `running`. When the status is `finished`, read the `files` array and use `file_url` from entries with `file_type: "audio"` to retrieve the music. For a `failed` task, read `error_message` and review the request before trying again. ## OpenAPI ````yaml api-manual/music-series/minimax-music-2-6.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - MiniMax Music 2.6 description: Generate songs and instrumental music from style prompts and lyrics. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Audio Series summary: MiniMax Music 2.6 description: >- Generate songs with custom or automatic lyrics, or create instrumental music. Retrieve the completed audio through Query Task Status or a callback_url notification. operationId: submit_minimax_music_2_6 requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string example: minimax/music-2.6 enum: - minimax/music-2.6 description: Model identifier for MiniMax Music 2.6. input: type: object required: - prompt additionalProperties: false properties: prompt: type: string minLength: 10 maxLength: 2000 description: >- 10–2000 characters describing genre, mood, instrumentation, tempo or vocal direction. lyrics: type: string maxLength: 3500 description: >- Up to 3500 characters. Supply lyrics when both is_instrumental and lyrics_optimizer are false. For instrumental music, leave lyrics empty. lyrics_optimizer: type: boolean default: false description: >- When true and lyrics is empty, generates lyrics from prompt. Set false for instrumental music. is_instrumental: type: boolean default: false description: >- Set true for instrumental music, with empty lyrics and lyrics_optimizer set to false. audio_setting: type: object additionalProperties: false properties: sample_rate: type: integer enum: - 16000 - 24000 - 32000 - 44100 default: 44100 description: Sample rate in Hz. bitrate: type: integer enum: - 32000 - 64000 - 128000 - 256000 default: 256000 description: Bitrate in bits per second. format: type: string enum: - mp3 - wav - pcm default: mp3 description: Audio file format. description: >- Audio output settings containing sample_rate, bitrate and format. description: >- Supply lyrics for vocal music, enable lyrics_optimizer with empty lyrics for automatic writing, or set is_instrumental to true with empty lyrics and lyrics_optimizer false. callback_url: type: string nullable: true description: >- Optional HTTP(S) callback URL for task completion or failure notifications. description: >- Set model and optional callback_url at the request root. Place music parameters inside input. examples: custom-lyrics: summary: Create a song with custom lyrics value: model: minimax/music-2.6 input: prompt: >- City pop, 100 BPM, warm female vocals, electric piano, rounded synth bass and a nostalgic evening mood lyrics: |- [Verse] The evening lights begin to glow We follow streets we used to know [Chorus] Carry the melody into the night Follow the rhythm until morning light lyrics_optimizer: false is_instrumental: false audio_setting: sample_rate: 44100 bitrate: 256000 format: mp3 automatic-lyrics: summary: Generate lyrics from the music prompt value: model: minimax/music-2.6 input: prompt: >- Uplifting indie folk song about a rooftop garden, acoustic guitar, gentle drums and warm English vocals lyrics_optimizer: true is_instrumental: false instrumental: summary: Create an instrumental track value: model: minimax/music-2.6 input: prompt: >- Instrumental ambient piano, soft strings, slow flowing rhythm and a peaceful morning atmosphere is_instrumental: true lyrics_optimizer: false audio_setting: sample_rate: 44100 bitrate: 256000 format: wav responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: task-unified-example status: running created_time: '2026-09-10T08:00:00' '400': description: >- Request validation failed or account credits are insufficient. Review the response detail and correct the request or account balance. content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: Invalid credentials content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: Rate or API key credit limit exceeded content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: Internal error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: Task submission failed. Review the response message and retry. content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: Model configuration or capability is not approved content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: Use VIDGO_API_KEY. ````