upload music

POST

https://api.musicapi.ai/api/v1/sonic/upload

Upload local songs and get the clip id for subsequent operations.

Sync mode (default): Returns clip_id directly in the response.

Async mode: When callback_url is provided, returns a task_id immediately and sends the result to your callback URL when the upload completes.

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

{
    "url": "https://audio.jukehost.co.uk/Ij5SXdAJKLg4tggS8T1xIH1Z0DuOWq5e.mp3"
}

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/upload' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://audio.jukehost.co.uk/Ij5SXdAJKLg4tggS8T1xIH1Z0DuOWq5e.mp3"
}'

Responses

🟢200成功

application/json

Upload successful. Returns clip_id in sync mode, or task_id in async mode.

Body

Examples

Sync mode responseAsync mode response (with callback_url)

{
    "code": 200,
    "clip_id": "cfbc3d3c-2add-4265-bcdf-924092096e3d",
    "message": "success"
}

🟠400请求有误

🟠401未认证

🟠403权限不足

🔴500服务器内部错误

Modified at 2026-02-23 08:07:00

replace section

get music