Music Generation API

POST

/minimaxi/v1/music_generation

Allows users to generate high-quality AI music with one click through natural language inspiration descriptions (prompt) and complete lyrics (lyrics), suitable for scenarios such as music creation, lyric composition, and AI singing voice generation.

Supported models and prices

Model Name	Price (PTC/time)
music-2.5	0.15
music-2.0	0.05
music-1.5	0.05

Official documentation: https://platform.minimaxi.com/docs/api-reference/music-generation

Request

Header Params

Body Params application/json

Example

{
    "model": "music-2.5",
    "prompt": "indie folk, melancholy, introspective, longing, solitary walk, coffee shop",
    "lyrics": "[verse]\nStreet lights dimly glow, evening breeze caresses\nShadows stretch long as I walk alone\nOld coat wrapped around deep melancholy\nNot knowing where to go, yearning for somewhere\n[chorus]\nPushing open the wooden door, fragrance fills the air\nFamiliar corner, strangers stare",
    "audio_setting": {
        "sample_rate": 44100,
        "bitrate": 256000,
        "format": "mp3"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/minimaxi/v1/music_generation' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "music-2.5",
    "prompt": "indie folk, melancholy, introspective, longing, solitary walk, coffee shop",
    "lyrics": "[verse]\nStreet lights dimly glow, evening breeze caresses\nShadows stretch long as I walk alone\nOld coat wrapped around deep melancholy\nNot knowing where to go, yearning for somewhere\n[chorus]\nPushing open the wooden door, fragrance fills the air\nFamiliar corner, strangers stare",
    "audio_setting": {
        "sample_rate": 44100,
        "bitrate": 256000,
        "format": "mp3"
    }
}'

Responses

🟢200success

application/json

Body

Example

{
    "data": {
        "audio": "https://minimax-algeng-chat-tts.oss-cn-wulanchabu.aliyuncs.com/audio%2Feffect%2F05cb5016f546a9b535e1bf90e5c3b045_1769741732855_6954.mp3?Expires=1769828132&OSSAccessKeyId=LTAI5tGLnRTkBjLuYPjNcKQ8&Signature=Dx%2Fm2h1HSEfoVuDiNL0DyybCypE%3D",
        "status": 2,
        "audio_url": "https://file.302.ai/gpt/imgs/20260130/98d09739b1044f3e8ec0e355bcfab10f.mp3"
    }
}

Modified at 2026-02-02 01:47:38

Files（Audio File Download）

Upload