Cover preprocessing

Use a reference audio URL or complete Base64 content to extract cover features. The cover_feature_id in the response is valid for 24 hours and can be sent with lyrics to the music generation API to create a cover.

The reference audio must be 6 seconds to 6 minutes long and no larger than 50 MB. You must provide exactly one of audio_url and audio_base64.

POST/v1/music_cover_preprocess

Extract cover features, lyrics, and song structure from reference audio. The same audio returns the same cover_feature_id, which is valid for 24 hours.

You must provide exactly one of audio_url and audio_base64. Reference audio must be 6 seconds to 6 minutes long and no larger than 50 MB.

Use minimax_music_cover_preprocess for preprocessing. After obtaining the feature ID, use music-cover to generate the cover.

Authorization

bearerAuth

AuthorizationBearer <token>

Use Bearer your-api-key in the Authorization Header.

In: header

Request Body

application/json

Reference audio and the fixed cover-model identifier.

TypeScript Definitions

Use the request body type in TypeScript.

You must provide exactly one of audio_url and audio_base64.

model*string

Cover preprocessing model ID, currently verified as minimax_music_cover_preprocess. After preprocessing, use music-cover to generate the cover.

audio_url?string

Public reference-audio URL that can be downloaded directly.

Formaturi

audio_base64?string

Complete audio Base64 without a Data URL prefix.

Response Body

`application/json`

curl -X POST "https://example.com/v1/music_cover_preprocess" \  -H "Content-Type: application/json" \  -d '{    "model": "minimax_music_cover_preprocess",    "audio_url": "https://example.com/song-with-vocals.mp3"  }'

{
  "cover_feature_id": "c81575b998100567b8d08eb1e9facf09",
  "formatted_lyrics": "[Verse]\nAmazing grace\nHow sweet the sound",
  "audio_duration": 15.283628117913832,
  "trace_id": "06d73273f48b188cf612905231003a28",
  "structure_result": "{\"num_segments\":1,\"segments\":[{\"start\":0,\"end\":15.241,\"label\":\"verse\"}]}",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Authorization

Request Body

Response Body

200application/json

401application/json

`application/json`

`application/json`