Skip to main content
POST
/
producer
/
upload
Upload Audio
curl --request POST \
  --url https://api.mountsea.ai/producer/upload \
  --header 'Content-Type: application/json' \
  --data '
{
  "audioUrl": "<string>"
}
'
{
  "taskId": "<string>"
}
Upload an audio file via URL for use with other Producer operations. Returns a taskId - use /producer/tasks to poll for the uploaded audio ID.

​
Request Body

​
audioUrl
string
required
URL of the audio file to upload (http/https supported).Supported formats: .mp3, .wav, .flac, .m4a, .aac, .ogg, .wma, .opusDuration limit: Maximum 4 minutes

​
Response

​
taskId
string
The task ID. Use this to query task status via Get Task Status.

​
Example

curl -X POST https://api.mountsea.ai/producer/upload \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "audioUrl": "https://example.com/my-song.mp3"
  }'

​
Response Example

{
  "taskId": "upload-task-abc123"
}

​
Task Result Example

When the upload completes, you’ll receive an id (audioId) that can be used with other operations: 
{
  "taskId": "upload-task-abc123",
  "status": "completed",
  "result": {
    "id": "a5683105-94a8-4348-b312-890280ee1842",
    "url": "https://storage.googleapis.com/corpusant-app-public/producer/raw/a5683105-94a8-4348-b312-890280ee1842.mp3",
    "lyrics": "[Intro]\n[Cinematic orchestral folk with driving percussion and sweeping strings]\n[0:00 - 1:11]\n\n[Verse 1]\n[Powerful female vocals]\nBeyond the hills where the shadows dance\nA whisper calls from a distant land\nEchoes of time in the ancient sand\nI'm reaching out, I'm reaching out\n\n[Chorus]\n(Ooh... ooh...)\nFollow the rhythm of the beating heart\nWhere the light and dark will never part\nWritten in stars, it's a sacred art\nI'm finding my way, I'm finding my way\n\n[Verse 2]\n(Ooh... ooh...)\nRising up like a golden flame\nNothing here will be the same\nBreaking free from the heavy chain\nI'm flying home, I'm flying home\n\n[Bridge]\n[Intense orchestration with melodic vocalizations]\n(Ah... ah...)\n(Ooh... ooh...)\n\n[Chorus]\nBeyond the hills where the shadows dance\nA whisper calls from a distant land\nEchoes of time in the ancient sand\nI'm reaching out, I'm reaching out\n\n[Outro]\n[Music swells then fades with lingering strings]",
    "isFlagged": false,
    "transcriptionJobId": "5e8fd759-c3bd-4ba9-928c-163081232cb9"
  }
}
FieldDescription
idThe audio ID to use with other operations
urlURL of the uploaded audio file
lyricsAuto-transcribed lyrics (if available)
isFlaggedContent moderation flag
transcriptionJobIdID of the transcription job
Ensure your audio URL is publicly accessible. Private or protected URLs will fail to upload.
After uploading, use the returned audioId with operations like extend_music, cover_music, or swap_music_vocals.