MusicAPI
HomeDocs
HomeDocs
  1. sonic
  • 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. sonic

create music

POST
https://api.musicapi.ai/api/v1/sonic/create

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
custom_mode
boolean 
required
If you want to customize the lyrics, this option should be true.
prompt
string 
required
song lyrics, should be less than 3000 characters
title
string 
optional
song title, should be less than 80 characters
tags
string 
optional
song tags, should be less than 200 characters
negative_tags
string 
optional
Elements you want to avoid in your songs
mv
string 
required
music model, which can be sonic-v3-5, sonic-v4
make_instrumental
boolean 
optional
instrumental mode
gpt_description_prompt
string 
optional
description of the music
Example
{
  "custom_mode": true,
  "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
  "title": "Starts",
  "tags": "pop",
  "negative_tags": "piano",
  "gpt_description_prompt": "",
  "make_instrumental": false,
  "mv": "sonic-v3-5"
}

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/sonic/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "custom_mode": true,
    "prompt": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
    "title": "Starts",
    "tags": "pop",
    "negative_tags":"piano",
    "gpt_description_prompt":"",
    "make_instrumental": false,
    "mv": "sonic-v3-5"
}'

Responses

🟢200success
application/json
Body
message
string 
required
task_id
string 
required
Example
{
  "message": "success",
  "task_id": "468d0e42-f7a6-40ce-9a4c-37db56b13b99"
}
Previous
Sonic Instructions
Next
extend music
Built with