- Introduction
- Credits Usage Guide
- Music API FAQ & Troubleshooting
- Common Scenarios
- Error handling
- sonic
- studio
- lyrics generation
- nuro
create music
POST
https://api.musicapi.ai/api/v1/nuro/create
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************
Body Params application/json
lyrics
string
required
<= 2000 characters
gender
enum<string>
optional
Allowed values:
FemaleMale
genre
enum<string>
optional
Allowed values:
FolkPopRockChinese StyleHip Hop/RapR&B/SoulPunkElectronicJazzReggaeDJPop PunkDiscoFuture BassPop RapTrap RapR&B RapChinoiserie ElectronicGuFeng MusicPop RockJazz PopBossa NovaContemporary R&B
mood
enum<string>
optional
Allowed values:
HappyDynamic/EnergeticSentimental/Melancholic/LonelyInspirational/HopefulNostalgic/MemoryExcitedSorrow/SadChillRomanticMissGroovy/FunkyDreamy/EtherealCalm/Relaxing
timbre
enum<string>
optional
Allowed values:
WarmBrightHuskyElectrified voiceSweet_AUDIO_TIMBRECute_AUDIO_TIMBRELoud and sonorousPowerfulSexy/Lazy
duration
integer
optional
>= 30<= 240
Example
{
"lyrics": "[intro] We were both young when I first saw you I close my eyes and the flashback starts I'm standin' there On a balcony in summer air [verse] See the lights, see the party, the ball gowns See you make your way through the crowd And say, 'Hello' Little did I know [pre-chorus] That you were Romeo, you were throwin' pebbles And my daddy said, 'Stay away from Juliet' And I was cryin' on the staircase Escape this town for a little while, oh oh [chorus] And said, 'Marry me, Juliet You'll never have to be alone I love you and that's all I really know I talked to your dad, go pick out a white dress It's a love story, baby, just say, 'Yes'' [inst] (Instrumental break) [bridge] I got tired of waiting Wondering if you were ever coming around My faith in you was fading When I met you on the outskirts of town [chorus] And I said, 'Romeo, save me I've been feeling so alone I keep waiting for you, but you never come Is this in my head? I don't know what to think' [outro] I talked to your dad, go pick out a white dress It's a love story, baby, just say, 'Yes' Oh, oh, oh 'Cause we were both young when I first saw you ",
"gender": "Female",
"genre": "Pop",
"mood": "Dynamic/Energetic",
"timbre": "Sweet_AUDIO_TIMBRE",
"duration": 200
}
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/nuro/create' \
--header 'Content-Type: application/json' \
--data-raw '{
"lyrics": "[intro] We were both young when I first saw you I close my eyes and the flashback starts I'\''m standin'\'' there On a balcony in summer air [verse] See the lights, see the party, the ball gowns See you make your way through the crowd And say, '\''Hello'\'' Little did I know [pre-chorus] That you were Romeo, you were throwin'\'' pebbles And my daddy said, '\''Stay away from Juliet'\'' And I was cryin'\'' on the staircase Escape this town for a little while, oh oh [chorus] And said, '\''Marry me, Juliet You'\''ll never have to be alone I love you and that'\''s all I really know I talked to your dad, go pick out a white dress It'\''s a love story, baby, just say, '\''Yes'\'''\'' [inst] (Instrumental break) [bridge] I got tired of waiting Wondering if you were ever coming around My faith in you was fading When I met you on the outskirts of town [chorus] And I said, '\''Romeo, save me I'\''ve been feeling so alone I keep waiting for you, but you never come Is this in my head? I don'\''t know what to think'\'' [outro] I talked to your dad, go pick out a white dress It'\''s a love story, baby, just say, '\''Yes'\'' Oh, oh, oh '\''Cause we were both young when I first saw you ",
"gender": "Female",
"genre": "Pop",
"mood": "Dynamic/Energetic",
"timbre": "Sweet_AUDIO_TIMBRE",
"duration": 200
}'
Responses
🟢200success
application/json
Body
message
string
required
task_id
string
required
Example
{
"message": "success",
"task_id": "4c35433b-1649-433d-b513-8422af70fbaa"
}
Modified at 2025-03-26 06:33:41