Submit Denoise Job

curl --request POST \
  --url https://api.munsit.com/api/v1/denoise \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form audio='@example-file'

import requests

url = "https://api.munsit.com/api/v1/denoise"

files = { "audio": ("example-file", open("example-file", "rb")) }
headers = {"x-api-key": "<api-key>"}

response = requests.post(url, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('audio', '<string>');

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

options.body = form;

fetch('https://api.munsit.com/api/v1/denoise', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.munsit.com/api/v1/denoise",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.munsit.com/api/v1/denoise"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.munsit.com/api/v1/denoise")
  .header("x-api-key", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.munsit.com/api/v1/denoise")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "jobId": "<string>",
  "denoiseId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "errorCode": "<string>",
  "errorMessage": "<string>"
}

{
  "errorCode": "<string>",
  "errorMessage": "<string>"
}

{
  "errorCode": "<string>",
  "errorMessage": "<string>"
}

{
  "errorCode": "<string>",
  "errorMessage": "<string>"
}

POST

denoise

Submit Denoise Job

curl --request POST \
  --url https://api.munsit.com/api/v1/denoise \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form audio='@example-file'

import requests

url = "https://api.munsit.com/api/v1/denoise"

files = { "audio": ("example-file", open("example-file", "rb")) }
headers = {"x-api-key": "<api-key>"}

response = requests.post(url, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('audio', '<string>');

const options = {method: 'POST', headers: {'x-api-key': '<api-key>'}};

options.body = form;

fetch('https://api.munsit.com/api/v1/denoise', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.munsit.com/api/v1/denoise",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.munsit.com/api/v1/denoise"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.munsit.com/api/v1/denoise")
  .header("x-api-key", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.munsit.com/api/v1/denoise")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"audio\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n<string>\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "jobId": "<string>",
  "denoiseId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "errorCode": "<string>",
  "errorMessage": "<string>"
}

{
  "errorCode": "<string>",
  "errorMessage": "<string>"
}

{
  "errorCode": "<string>",
  "errorMessage": "<string>"
}

{
  "errorCode": "<string>",
  "errorMessage": "<string>"
}

Queues an audio (or video) file for voice isolation. The endpoint accepts the upload, persists the original, creates a pending record, and enqueues a background job. Use the returned denoiseId with the progress SSE endpoint to track completion.

Authentication

Requires API key authentication via x-api-key header.

Request

Content-Type: multipart/form-data

Form Data

Field	Type	Required	Description
`audio`	File	Yes	Audio or video file to denoise (max 200 MB, max 15 minutes duration)

File Limits

Maximum file size: 200 MB
Maximum duration: 15 minutes
Source type detection: files with extension mp4, mov, mkv, webm, avi, or m4v are treated as video and their audio track is extracted before denoising. All other extensions are treated as audio.

Supported audio formats: WAV, MP3, M4A, FLAC, OGG.

Response

Status Code: 200 OK Content-Type: application/json

Response Schema

Field	Type	Description
`jobId`	string	Identifier of the queued background job. Mirrors `denoiseId`.
`denoiseId`	string (UUID)	Unique identifier of the denoising record. Use this with the progress and list endpoints.

Example Response

{
  "jobId": "5b1d2f7e-3f81-4c2a-9c5d-7a2e91b4c7a1",
  "denoiseId": "5b1d2f7e-3f81-4c2a-9c5d-7a2e91b4c7a1"
}

Error Responses

400 Bad Request

{
  "errorCode": "400xx",
  "errorMessage": "audio is required and must be a file"
}

{
  "errorCode": "400xx",
  "errorMessage": "File size exceeds the maximum limit of 200MB. File size: <n>MB"
}

{
  "errorCode": "400xx",
  "errorMessage": "Duration exceeds the maximum limit of 15 minutes. Duration: <n> minutes"
}

401 Unauthorized

{
  "errorCode": "40101",
  "errorMessage": "Invalid or missing API key"
}

402 Payment Required

{
  "errorCode": "40201",
  "errorMessage": "Insufficient wallet balance"
}

Example Usage

JavaScript

const formData = new FormData();
const audioFile = document.querySelector('input[type="file"]').files[0];
formData.append("audio", audioFile);

const response = await fetch('https://api.munsit.com/api/v1/denoise', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    // Note: Content-Type is set automatically by FormData
  },
  body: formData,
});

if (response.ok) {
  const { jobId, denoiseId } = await response.json();
  console.log('Queued denoising', { jobId, denoiseId });
  // Next: subscribe to /denoise/{denoiseId}/progress for live updates
} else {
  const error = await response.json();
  console.error('Error:', error);
}

Python

import requests

url = "https://api.munsit.com/api/v1/denoise"
headers = {
    "x-api-key": "YOUR_API_KEY"
}

with open("input_audio.wav", "rb") as audio_file:
    files = {"audio": audio_file}
    response = requests.post(url, files=files, headers=headers)

if response.status_code == 200:
    data = response.json()
    print(f"Queued denoising: denoiseId={data['denoiseId']}")
else:
    print(f"Error: {response.status_code} - {response.text}")

cURL

curl -X POST "https://api.munsit.com/api/v1/denoise" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "audio=@input_audio.wav"

Async workflow: This endpoint only enqueues the job. The denoised audio URL is delivered via the progress SSE endpoint (done event) or can be fetched from the list endpoint once the record’s status is success.

Authorizations

x-api-key

string

header

required

API key for authentication

Body

multipart/form-data

audio

file

required

Audio or video file to denoise (max 200 MB, max 15 minutes duration). Video containers (mp4, mov, mkv, webm, avi, m4v) have their audio track extracted automatically.

Response

Denoising job queued

jobId

string

required

Background job identifier (mirrors denoiseId).

denoiseId

string<uuid>

required

Unique identifier of the denoising record. Use this with /denoise/{denoiseId}/progress and as the record id in /denoise.

Voice Clone

Stream Denoise Progress

Getting Started

Text To Speech

Speech to Text

Voice Cloning

Voice Isolation

Translation

Tashkil

Submit Denoise Job

Authentication

Request

Form Data

File Limits

Response

Response Schema

Example Response

Error Responses

Example Usage

JavaScript

Python

cURL

Authorizations

Body

Response

​Authentication

​Request

​Form Data

​File Limits

​Response

​Response Schema

​Example Response

​Error Responses

​Example Usage

​JavaScript

​Python

​cURL

Authorizations

Body

Response

Authentication

Request

Form Data

File Limits

Response

Response Schema

Example Response

Error Responses

Example Usage

JavaScript

Python

cURL