- Introduction
- Credits Usage Guide
- Music API FAQ & Troubleshooting
- Common Scenarios
- Error handling
- sonic
- studio
- lyrics generation
- nuro
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
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"
}
Modified at 2024-12-03 14:17:16