create music with persona

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

task_type

string

required

Task type, can be create_music, extend_music, concat_music, cover_music, extend_upload_music, persona_music

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

persona_id

string

required

the persona id generated by create persona endpoint

enum<string>

required

music model, which can be sonic-v3-5, sonic-v4,sonic-v4-5

Allowed values:

sonic-v3-5sonic-v4sonic-v4-5

Example

{
    "task_type":"persona_music",
    "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",
    "persona_id":"c08806c1-34fa-4290-a78d-0c623eb1dd1c",
    "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 '{
    "task_type":"persona_music",
    "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",
    "persona_id":"c08806c1-34fa-4290-a78d-0c623eb1dd1c",
    "mv": "sonic-v3-5"
}'

Responses

🟢200success

application/json

Body

message

string

required

task_id

string

required

Example

{
    "message": "success",
    "task_id": "81ed9f60-56ae-48c1-9c46-33a8220dfca7"
}

Modified at 2025-06-26 16:53:07

create persona

upload music