AGRouter

Appearance

MiniMax Music 2.6

POST/v1/run

MiniMax Music 2.6 text-to-music model with enhanced quality, lyrics support, instrumental generation, and configurable audio output.

Request body

Submit an async generation request. The model field selects the model; other fields are model-specific input parameters.

stringmodelrequired

Model identifier. Set to minimax/music/2.6.

Default: minimax/music/2.6

stringpromptrequired

A description of the music style, mood, genre, and scenario.

Default: Indie folk, melancholic, introspective, longing, solitary walk, coffee shop

Optional<string>lyrics

Lyrics of the song. Use \n to separate lines. Supports structure tags: [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge], [Outro], [Interlude], [Hook], [Break], [Solo], [Inst].

Default: [verse] Streetlights flicker, the night breeze sighs Shadows stretch as I walk alone An old coat wraps my silent sorrow Wandering, longing, where should I go [chorus] Pushing the wooden door, the aroma spreads In a familiar corner, a stranger gazes

Optional<boolean>is_instrumental

When true, generates vocal-free instrumental music.

Default: false

Optional<boolean>lyrics_optimizer

When true and lyrics is empty, auto-generates lyrics from the prompt.

Default: false

Optional<integer>sample_rate

Sample rate of generated audio.

Allowed values: 16000, 24000, 32000, 44100

Optional<integer>bitrate

Bitrate of generated audio.

Allowed values: 32000, 64000, 128000, 256000

Optional<string>format

Format of generated audio.

Allowed values: mp3, wav, pcm

Response Schema

The submit endpoint returns a run response. If its status is pending or running, poll GET /v1/run/{id} with the returned opaque ID until it reaches a terminal state.

stringidrequired

Opaque AGRouter run identifier. Use it exactly as returned; no prefix is guaranteed.

stringstatusrequired

Current public run status.

Allowed values: pending, running, completed, failed, timeout

Optional<string>model

Public AGRouter model name used for this run.

Optional<array<object>>outputs

Present only for completed runs. Each object is capability-specific; inspect the selected model schema for its fields.

Optional<object>error

Present only for failed or timeout runs. Contains a public error type and sanitized message.

Optional<string>error.type

Stable public error category.

Optional<string>error.message

Sanitized error message safe to show to clients.

Optional<object>usage

Usage details when available.

Model capabilities

array<string>capability_tagsrequired

Capabilities declared by the model registry.

Default: text-to-music

stringexecution_moderequired

Execution mode declared by the model registry.

Default: async