MiniMax Music 2.6 - Vidgo API

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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]\nThe evening lights begin to glow\nWe follow streets we used to know\n[Chorus]\nCarry the melody into the night\nFollow the rhythm until morning light",
    "lyrics_optimizer": false,
    "is_instrumental": false,
    "audio_setting": {
      "sample_rate": 44100,
      "bitrate": 256000,
      "format": "mp3"
    }
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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]\nThe evening lights begin to glow\nWe follow streets we used to know\n[Chorus]\nCarry the melody into the night\nFollow the rhythm until morning light",
    "lyrics_optimizer": false,
    "is_instrumental": false,
    "audio_setting": {
      "sample_rate": 44100,
      "bitrate": 256000,
      "format": "mp3"
    }
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

Create complete songs and instrumental tracks from a style prompt. Describe genre, mood, instrumentation, tempo and vocal direction to guide the music.

Models

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.

Authorizations

Authorization

string

header

required

Use VIDGO_API_KEY.

Body

application/json

Set model and optional callback_url at the request root. Place music parameters inside input.

model

enum<string>

required

Model identifier for MiniMax Music 2.6.

Available options:

minimax/music-2.6

Example:

"minimax/music-2.6"

input

object

required

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.

Show child attributes

callback_url

string | null

Optional HTTP(S) callback URL for task completion or failure notifications.

Response

Task submitted

code

enum<integer>

required

Available options:

200

data

object

required

Show child attributes

​Models

​Music Parameters

​Creation Modes

​Custom Lyrics

​Automatic Lyrics

​Instrumental Music

​Audio Settings

​Retrieve the Audio

Authorizations

Body

Response

Models

Music Parameters

Creation Modes

Custom Lyrics

Automatic Lyrics

Instrumental Music

Audio Settings

Retrieve the Audio