Upload Audio

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

Field	Type	Required	Description
`file`	file	✅	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"
}

Library Ingest Audio

Get Started

Frequently Asked Questions

Creating with Soundverse

Exploring Soundverse

Account Management

Enterprise Platform

API Documentation

Upload File

Request Headers

Request Body

Response

Error Responses

​Upload File

​Request Headers

​Request Body

​Response

​Error Responses

Upload File

Request Headers

Request Body

Response

Error Responses