MusicAPI

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

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Modified at 2025-01-17 14:51:03

Sonic Instructions

extend music