music-01

This documentation is valid for the following list of our models:

• music-01

Model Overview

An advanced AI model that generates diverse high-quality audio compositions by analyzing and reproducing musical patterns, rhythms, and vocal styles from the reference track. Refine the process using a text prompt.

Setup your API Key

If you don’t have an API key for the Apilaplas API yet, feel free to use our Quickstart guide.

Submit a request

API Schema

post

Authorizations

access-token

AuthorizationstringRequired

Bearer key

Body

application/json

purposestring · enumRequired

1. If purpose is song:

• You need to upload a music file containing both acapella (vocals) and accompaniment.
• The acapella must be in singing form; normal speech is not supported.
• Outputs: voice_id and instrumental_id.

2. If purpose is voice:

• You need to upload a file containing only acapella in singing form (normal speech audio is not supported).
• Output: voice_id.

3. If purpose is instrumental:

• You need to upload a file containing only accompaniment.
• Output: instrumental_id.

Possible values:

Responses

default

application/json

post

/v2/generate/audio/minimax/upload

HTTPcURLJavaScriptPython

POST /v2/generate/audio/minimax/upload HTTP/1.1
Host: api.apilaplas.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "purpose": "song"
}

default

{
  "voice_id": "vocal-2025011003141025-d5ZEMxmp",
  "instrumental_id": "instrumental-2025011003141125-Akz9eWnD",
  "base_resp": {
    "status_code": 1,
    "status_msg": "text"
  }
}

post

Authorizations

access-token

AuthorizationstringRequired

Bearer key

Body

application/json

lyricsstringRequired

You can use a newline character (\n) to separate each line of lyrics. You can use two consecutive newline characters (\n\n) to add a pause between lines. You can use double hash marks (##) at the beginning and end of the lyrics to add accompaniment.

Example: ##Swift and Boundless In the realm of innovation, where visions align, LAPLAS API's the name, making tech shine. Intelligent solutions, breaking the mold, Swift inference power, bold and untold. ##

modelstring · enumRequired

Model id

Possible values:

refer_voicestringOptional

At least one of refer_voice or refer_instrumental is required. When only refer_voice is provided, the system can still output music data. The generated music will be an a cappella vocal hum that aligns with the provided refer_voice and the generated lyrics, without any instrumental accompaniment.

Example: vocal-2025010100000000-a0AAAaaa

refer_instrumentalstringOptional

At least one of refer_voice or refer_instrumental is required. When only refer_instrumental is provided, the system can still output music data. The generated music will be a purely instrumental track that aligns with the provided refer_instrumental, without any vocals.

Example: instrumental-2025010100000000-Aaa0aAaA

Responses

default

application/json

post

/v2/generate/audio/minimax/generate

HTTPcURLJavaScriptPython

POST /v2/generate/audio/minimax/generate HTTP/1.1
Host: api.apilaplas.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 422

{
  "lyrics": "##Swift and Boundless \n In the realm of innovation, where visions align, \n\nLAPLAS API's the name, making tech shine. \nIntelligent solutions, breaking the mold, \n\nSwift inference power, bold and untold.\n##",
  "model": "music-01",
  "audio_setting": {
    "sample_rate": 16000,
    "bitrate": 32000,
    "format": "mp3"
  },
  "refer_voice": "vocal-2025010100000000-a0AAAaaa",
  "refer_instrumental": "instrumental-2025010100000000-Aaa0aAaA"
}

default

{
  "data": {
    "status": 1,
    "audio": "text"
  },
  "extra_info": {
    "audio_length": 1,
    "audio_size": 1,
    "audio_bitrate": 1,
    "audio_sample_rate": 1
  },
  "trace_id": "text",
  "base_resp": {
    "status_code": 1,
    "status_msg": "text"
  }
}