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
  • get-credits
    GET
  1. nuro

create instrument 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
description
string 
required
music description
genre
array[string]
optional
music genre, multiple selections are allowed, it is a string array, max 5
<= 5 items
Allowed values:
corporatedance/edmorchestralchill outrockhip hopfolkfunkambientholidayjazzkidsworldtravelcommercialadvertisingdrivingcinematicupbeatepicinspiringbusinessvideo gamedarkpoptrailermodernelectronicdocumentarysoundtrackfashionacousticmovietvhigh techindustrialdancevideovlogmarketinggameradiopromotionalsportspartysummerbeauty
mood
array[string]
optional
music mood, multiple selections are allowed, it is a string array, max 5
<= 5 items
Allowed values:
positiveupliftingenergetichappybrightoptimistichopefulcooldreamyfunlightpowerfulcalmconfidentjoyfuldramaticpeacefulplayfulsoftgroovyreflectiveeasyrelaxedlivelysmoothromanticintenseelegantmellowemotionalsentimentalcheerful happycontemplativesoothingproudpassionatesweetmysticaltranquilcheerfulcasualbeautifuletherealmelancholysadaggressivehauntingadventureserenesincerefunkyfunny
instrument
array[string]
optional
music instrument, multiple selections are allowed, it is a string array, max 5
<= 5 items
Allowed values:
pianodrumsguitarpercussionsynthelectric guitaracoustic guitarbass guitarbrassviolincellofluteorgantrumpetukulelesaxophonedouble bassharpglockenspielsynthesizerkeyboardmarimbabassbanjostrings
theme
array[string]
optional
music theme, multiple selections are allowed, it is a string array, max 5
<= 5 items
Allowed values:
inspirationalmotivationalachievementdiscoveryevery daylovetechnologylifestylejourneymeditationdramachildrenhopefantasyholidayhealthfamilyreal estatemediakidsscienceeducationprogressworldvacationtrainingchristmassales
duration
integer 
optional
>= 1<= 60
Default:
60
Example
{
  "type": "bgm",
  "description": "Intense and tense game battle background music with epic momentum",
  "genre": ["video game", "electronic", "epic", "cinematic"],
  "mood": ["powerful", "energetic", "intense", "aggressive"],
  "instrument": ["drums", "synth", "brass", "strings"],
  "theme": ["achievement", "fantasy", "drama"],
  "duration": 35
}

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": "bgm",
  "description": "Intense and tense game battle background music with epic momentum",
  "genre": ["video game", "electronic", "epic", "cinematic"],
  "mood": ["powerful", "energetic", "intense", "aggressive"],
  "instrument": ["drums", "synth", "brass", "strings"],
  "theme": ["achievement", "fantasy", "drama"],
  "duration": 35
}'

Responses

🟢200success
application/json
Body
message
string 
required
task_id
string 
required
Example
{
    "message": "success",
    "task_id": "b1eac403-06cb-4e58-971d-835d3b321508"
}
Modified at 2025-04-09 11:11:56
Previous
create vocal music
Next
get music
Built with