create voice

POST

https://api.musicapi.ai/api/v1/sonic/create-voice

Create a custom voice persona from an audio file containing clear vocals. This is an async endpoint — submit the audio URL, receive a task_id, then poll for the result.

Credits cost: 4

Workflow:

Submit a publicly accessible audio URL (MP3 or WAV, >10s, single clear speaker)

Receive a task_id in the response

Poll GET /api/v1/sonic/task/{task_id} until the task completes

The completed task returns a persona_id

Use the persona_id with POST /api/v1/sonic/create (task_type: persona_music) to generate music with that voice

Polling Result

Use GET /api/v1/sonic/task/{task_id} to poll the result.

{
  "code": 200,
  "data": {
    "persona_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Voice Name"
  },
  "message": "success"
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
  "audio_url": "https://example.com/my-vocal-recording.mp3",
  "webhook_url": "https://myapp.com/api/voice-callback",
  "webhook_secret": "my-secret-key"
}

Request Code 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-voice' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "audio_url": "https://example.com/my-vocal-recording.mp3",
  "webhook_url": "https://myapp.com/api/voice-callback",
  "webhook_secret": "my-secret-key"
}'

Responses

🟢200OK

application/json

Body

Example

{
    "code": "string",
    "message": "string",
    "task_id": "string"
}

Modified at 2026-03-31 16:24:15

upload music

get music