MusicAPI

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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"
}

Modified at 2025-04-09 11:02:56

Error handling

create instrument music