Skip to main content

​
Upload File

Upload a raw audio track (e.g. WAV, MP3, FLAC, M4A) to secure cloud storage. This endpoint is completely free and does not deduct from your plan balance. The returned blob_name must be used as the identifier in ingest and search requests.
  • /trace/v1/upload

​
Request Headers

Content-Type: multipart/form-data

​
Request Body

FieldTypeRequiredDescription
filefile✅The raw audio file to upload. Max file size: 100 MB.

​
Response

Status 200 OK 
{
  "success": true,
  "message": "Upload successful",
  "data": {
    "blob_name": "dataset/123e4567-e89b-12d3-a456-426614174000_song_candidate_1.wav"
  }
}

​
Error Responses

Payload Too Large (413) Returned if the uploaded file exceeds the 100 MB limit. 
{
  "success": false,
  "message": "Upload file size exceeds the maximum limit of 100 MB."
}
Unsupported Format (400) Returned if the file format is not supported (only .mp3, .wav, .flac, .m4a are allowed). 
{
  "success": false,
  "message": "Unsupported audio format. Use .mp3, .wav, .flac, or .m4a"
}