MusicAPI

custom mode (Use case3)

POST

https://api.musicapi.ai/api/v1/studio/create

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

prompt

string

required

lyrics

string

required

lyrics_type

string

required

bypass_prompt_optimization

boolean

optional

seed

integer

optional

song_section_start

integer

optional

song_section_end

integer

optional

lyrics_placement_start

integer

optional

lyrics_placement_end

number

optional

prompt_strength

number

required

clarity_strength

number

required

lyrics_strength

number

required

generation_quality

number

required

negative_prompt

string

optional

model_type

string

required

config

object

required

mode

string

required

Example

{
  "prompt": "rock, pop soul, electronic, ",
  "lyrics": "In the garden, seeds of dreams,Growing wild, bursting at the seams.Nature whispers, soft and clear,Feel the warmth, the sun draws near.In the garden, seeds of dreams,Growing wild, bursting at the seams.Nature whispers, soft and clear,Feel the warmth, the sun draws near.",
  "lyrics_type": "user",
  "bypass_prompt_optimization": false,
  "seed": -1,
  "song_section_start": 0,
  "song_section_end": 1,
  "lyrics_placement_start": 0,
  "lyrics_placement_end": 0.95,
  "prompt_strength": 0.5,
  "clarity_strength": 0.25,
  "lyrics_strength": 0.5,
  "generation_quality": 0.75,
  "negative_prompt": "",
  "model_type": "studio130-v1.5",
  "config": {
    "mode": "regular"
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.musicapi.ai/api/v1/studio/create' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "rock, pop soul, electronic, ",
  "lyrics": "In the garden, seeds of dreams,Growing wild, bursting at the seams.Nature whispers, soft and clear,Feel the warmth, the sun draws near.In the garden, seeds of dreams,Growing wild, bursting at the seams.Nature whispers, soft and clear,Feel the warmth, the sun draws near.",
  "lyrics_type": "user",
  "bypass_prompt_optimization": false,
  "seed": -1,
  "song_section_start": 0,
  "song_section_end": 1,
  "lyrics_placement_start": 0,
  "lyrics_placement_end": 0.95,
  "prompt_strength": 0.5,
  "clarity_strength": 0.25,
  "lyrics_strength": 0.5,
  "generation_quality": 0.75,
  "negative_prompt": "",
  "model_type": "studio130-v1.5",
  "config": {
    "mode": "regular"
  }
}'

Responses

🟢200success

application/json

Body

code

string

required

message

string

required

data

string

required

Example

{
  "code": "success",
  "message": "",
  "data": "1938c07e-be59-4cfe-af63-55c22201e10b"
}

extend mode (Use case2)

instrumental mode (Use case4)