Music Generation API

POST

/minimaxi/v1/music_generation

接口说明
Pass the voice_id (vocals), instrumental_id (accompaniment), and other music information output by the Upload API to the Music Generation API to generate corresponding AI music. This API will generate AI vocals and accompaniment based on the voice_id and instrumental_id.
Official documentation：https://platform.minimaxi.com/document/Music%20Generation?key=667cd92e3be2027f69b723dd

Request

Authorization

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Content-Type

string

optional

Example:

application/json

Body Params multipart/form-data

refer_voice

string

optional

Refer to timbre ID when generating music. Generated via /v1/music_upload.

At least one of refer_voice or refer_instrumental is required.

If only refer_voice is provided, the system can output music data normally. The generated music will be a segment of dry vocal humming that aligns with refer_voice and the provided lyrics, without any instrumental accompaniment.

refer_instrumental

string

optional

Refer to accompaniment ID when generating music. Generated via /v1/music_upload.

At least one of refer_voice or refer_instrumental is required.

If only refer_instrumental is provided, the system can output music data normally. The generated music will be a segment of pure instrumental music that aligns with refer_instrumental, without any vocals.

lyrics

string

required

Lyrics: Use a newline character (\n) to separate each line of lyrics. Use two consecutive newline characters (\n\n) to insert a pause in the middle of the lyrics. Add double hashes (##) at the beginning and end of the lyrics to include instrumental accompaniment. The maximum length supported is 200 characters (each Chinese character, punctuation mark, and letter counts as 1 character).

model

string

required

Support model：music-01。

Example:

music-01

Request 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 sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--form 'refer_voice=""' \
--form 'refer_instrumental=""' \
--form 'lyrics=""' \
--form 'model="music-01"'

Responses

🟢200成功

application/json

Body

object {0}

Example

{}

Modified at 2024-12-11 07:41:50

Music_Upload（Upload original music）

T2A (voice generation-synchronization)