Endpoint
clipId can be used in Add Instrumental or Sample operations.
Music Generation
Upload Audio
Upload an audio file by URL and get a clip ID for use in downstream operations
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Upload an audio file by URL and get a clip ID for use in downstream operations
POST /api/v1/music/upload
clipId can be used in Add Instrumental or Sample operations.
| Field | Type | Required | Description |
|---|---|---|---|
audio_url | string | Yes | Publicly accessible URL of the audio file to upload. |
{
"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. |
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"
}'