Upload Audio

Endpoint

POST /api/v1/music/upload

Synchronous. Returns clip metadata immediately after upload completes. Upload an external audio file (MP3, WAV, etc.) by providing its URL. The returned clipId can be used in Add Instrumental or Sample operations.

Request body

Field	Type	Required	Description
`audio_url`	string	Yes	Publicly accessible URL of the audio file to upload.

Response

{
  "code": 0,
  "message": "ok",
  "request_id": "req-1710000000000",
  "data": {
    "clipId": "abc123def456",
    "audioUrl": "https://cdn.example.com/audio/abc123def456.mp3",
    "duration": 30,
    "status": 1
  }
}

Field	Type	Description
`clipId`	string	Clip ID to use in subsequent operations.
`audioUrl`	string	Processed audio URL.
`duration`	integer	Audio duration in seconds.
`status`	integer	Upload status code. `1` = ready.

Example

curl -X POST https://api.example.com/api/v1/music/upload \
  -H "Authorization: Bearer sk-mm-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://example.com/vocals.mp3"
  }'

Infill (Replace Section)Concat

Getting Started

Overview

Music Generation

Lyrics

Audio Processing

AI Singer (Persona)

Tasks & Results

Endpoint

Request body

Response

Example

​Endpoint

​Request body

​Response

​Example

Endpoint

Request body

Response

Example