MusicAPI
HomeDocs
HomeDocs
  1. sonic
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Special Scenarios
  • Error handling
  • Webhook Integration Guide
  • sonic
    • Sonic Instructions
    • create music (custom mode)
      POST
    • create music (no-custom mode)
      POST
    • create music (Control singer gender)
      POST
    • create music (auto lyrics mode)
      POST
    • extend music
      POST
    • concat music
      POST
    • cover music
      POST
    • stems basic
      POST
    • stems full
      POST
    • create persona
      POST
    • create music with persona
      POST
    • upload music
      POST
    • get wav
      POST
    • get midi
      POST
    • get music
      GET
  • riffusion(Deprecated)
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • producer
    • Producer instructions
    • Complete Request Examples
    • create music
    • upload
    • download
    • get music
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
    • extend mode (Use case2)
    • custom mode (Use case3)
    • instrumental mode (Use case4)
    • get music
  • lyrics generation
    • Make Lyrics
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
    • create instrument music
    • get music
  • get-credits
    GET
  1. sonic

create persona

POST
https://api.musicapi.ai/api/v1/sonic/persona
Get the virtual singer for the corresponding song(use latest clip id in 24 hours)

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "name":"test persona",
    "clip_id":"042e3c92-057d-4b43-800f-b7e4daf43521" // (latest clip id in 24 hours) 
}

Request Code 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/persona' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name":"test persona",
    "clip_id":"042e3c92-057d-4b43-800f-b7e4daf43521" // (latest clip id in 24 hours) 
}'

Responses

🟢200success
application/json
Body

Example
{
    "code": 200,
    "persona_id": "c08806c1-34fa-4290-a78d-0c623eb1dd1c",
    "message": "success"
}
Modified at 2025-10-28 04:43:58
Previous
stems full
Next
create music with persona
Built with