MusicAPI
HomeDocs
HomeDocs
  1. nuro
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Common Scenarios
  • Error handling
  • sonic
    • Sonic Instructions
    • create music
      POST
    • extend music
      POST
    • concat music
      POST
    • cover music
      POST
    • create persona
      POST
    • create music with persona
      POST
    • upload music
      POST
    • get music
      GET
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
      POST
    • extend mode (Use case2)
      POST
    • custom mode (Use case3)
      POST
    • instrumental mode (Use case4)
      POST
    • get music
      GET
  • lyrics generation
    • Make Lyrics
      POST
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
      POST
    • create instrument music
      POST
    • get music
      GET
  1. nuro

create vocal 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
type
enum<string> 
required
music type
Allowed values:
vocalbgm
lyrics
string 
required
song lyrics, max 2000 characters
<= 2000 characters
gender
enum<string> 
optional
The singer's gender. If not provided, the service will automatically predict it.
Allowed values:
FemaleMale
genre
enum<string> 
optional
The genre of the song. If you don't specify it, the service will automatically predict it.
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
The mood of the song, if not provided, the service will automatically predict it
Allowed values:
HappyDynamic/EnergeticSentimental/Melancholic/LonelyInspirational/HopefulNostalgic/MemoryExcitedSorrow/SadChillRomanticMissGroovy/FunkyDreamy/EtherealCalm/Relaxing
timbre
enum<string> 
optional
The timbre of the song. If not provided, the service will automatically predict it.
Allowed values:
WarmBrightHuskyElectrified voiceSweet_AUDIO_TIMBRECute_AUDIO_TIMBRELoud and sonorousPowerfulSexy/Lazy
duration
integer 
optional
Duration of the song , The duration of the song, the default is 2 minutes, [30,240]
>= 30<= 240
Default:
120
Example
{
  "type": "vocal",
  "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 '{
    "type":"vocal",
    "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"
}
Previous
Error handling
Next
create instrument music
Built with