{ "openapi": "3.0.1", "info": { "title": "Audio Noise Remover API: Clean Speech in MP3, WAV, MP4", "description": "Remove background noise, hiss and room echo from speech in MP3, WAV, M4A or MP4 URLs with the DeepFilterNet AI model. Clean file download, loudness-normalised, with before/after noise floor and LUFS. $0.02 per audio minute.", "version": "1.0", "x-build-id": "C6V4d7z0cNtPfCTF6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/magnova~audio-noise-remover/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-magnova-audio-noise-remover", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/magnova~audio-noise-remover/runs": { "post": { "operationId": "runs-sync-magnova-audio-noise-remover", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/magnova~audio-noise-remover/run-sync": { "post": { "operationId": "run-sync-magnova-audio-noise-remover", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "sources" ], "properties": { "sources": { "title": "Audio or video file URLs", "type": "array", "description": "Direct links to speech recordings you own or have rights to: MP3, WAV, M4A/AAC, FLAC, OGG, OPUS, MP4, MOV or WEBM (podcasts, interviews, voice memos, calls, lectures, screen recordings). Each file becomes one cleaned file. YouTube, Spotify, SoundCloud, TikTok, Instagram and other streaming or social page URLs are rejected for free. Example: https://upload.wikimedia.org/wikipedia/commons/a/a5/Live_recording_of_interview_with_Dr_Amba_Ambaiowei_Pt_1.opus", "items": { "type": "string" } }, "reduction": { "title": "Noise reduction strength", "enum": [ "maximum", "strong", "medium", "gentle" ], "type": "string", "description": "How much background noise may be removed. maximum = no limit (best for hiss, hum, fans, traffic, keyboard, room noise); strong = up to 35 dB; medium = up to 20 dB (keeps some natural room tone); gentle = up to 12 dB (barely audible processing). Example: medium for interviews that should still sound like a room.", "default": "maximum" }, "postFilter": { "title": "Extra residual-noise filter", "type": "boolean", "description": "Adds DeepFilterNet's post-filter, which suppresses faint leftover noise in very noisy recordings at the cost of slightly more processed sound. Leave off for normal recordings.", "default": false }, "highPassHz": { "title": "Rumble filter (Hz)", "minimum": 20, "maximum": 400, "type": "integer", "description": "Optional: cut everything below this frequency before cleaning, to remove desk thumps, wind and mains rumble. 80 Hz suits most voices. Leave empty for no filter. Example: 80." }, "normalizeLoudness": { "title": "Normalise loudness", "type": "boolean", "description": "Two-pass EBU R128 loudness normalisation of the cleaned audio so episodes sound equally loud. Turn off to keep the original level.", "default": true }, "targetLufs": { "title": "Target loudness (LUFS)", "minimum": -40, "maximum": -5, "type": "number", "description": "Integrated loudness target when normalisation is on. -16 = podcasts (Apple, Spotify mono/stereo), -14 = YouTube and streaming, -23 = EBU R128 broadcast. Example: -16.", "default": -16 }, "outputFormat": { "title": "Output format", "enum": [ "mp3", "m4a", "wav", "flac", "opus" ], "type": "string", "description": "File type for audio-only output. mp3 (192 kbps by default) is smallest and works everywhere; m4a is AAC; wav and flac are lossless 48 kHz; opus is tiny for voice. Files with a video track follow keepVideo instead.", "default": "mp3" }, "bitrateKbps": { "title": "Bitrate (kbps)", "minimum": 32, "maximum": 320, "type": "integer", "description": "Bitrate for mp3, m4a and opus output (ignored for wav and flac, and for opus use 64-96 for speech). Example: 128.", "default": 192 }, "keepVideo": { "title": "Keep the video track", "type": "boolean", "description": "When a source is a video, return the video with the cleaned audio swapped in (video stream copied, not re-encoded, so it is fast and lossless). Turn off to get audio only in the chosen output format.", "default": true }, "maxMinutesPerFile": { "title": "Max minutes per file", "minimum": 0.1, "maximum": 600, "type": "number", "description": "Optional cap: clean only the first N minutes of each file (you pay only for what is cleaned). Leave empty for full files. Example: 30." }, "maxFileSizeMb": { "title": "Max file size (MB)", "minimum": 1, "maximum": 4000, "type": "integer", "description": "Files larger than this are skipped with an error row (not charged). Example: 500.", "default": 1000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }