Skip to content
Documentation

Audio Cleaner — Audio & Video Noise Reduction

Reduce background noise in audio and video, with media inspection, audio technical analysis, and waveform generation.

Processing from 10 credits

Audio Cleaner — Audio & Video Noise Reduction

Reduce background noise in audio and video, with media inspection, audio technical analysis, and waveform generation.

Creating a task is free and occupies a lifecycle slot. Before the first upload URLs are issued, 50 credits are reserved. On success, the original reservation is fully returned, then the full processing fee is charged. Returns from expired subscription credits do not restore available credit; the successful processing fee may create an outstanding balance.

Cancellation, expiry before success, and invalid files retain any reserved 50 credits. Service failures return the reservation; uncertain failures require reconciliation. No reservation means no charge. Expiry of an already successful result does not change its settlement.

Billing uses the default audio track, or the first track when no default exists. For the verified complete track duration D and original input channel count C, M=ceil(D/60) and CM=C×M. A 61-second stereo file costs 100 credits for denoising, 10 for inspection, 60 for analysis, or 40 for waveform generation.

Files

Audio Cleaner · Get Upload Part URLs

Validate parts and obtain temporary upload URLs. The first URLs are issued only after the credit reservation is confirmed.

Parameters

ParameterExample
task_id"00000000-0000-4000-8000-000000000001"
parts[{"part_number": 1, "content_md5": "AAAAAAAAAAAAAAAAAAAAAA=="}]

Request

Code example
{
  "task_id": "00000000-0000-4000-8000-000000000001",
  "parts": [
    {
      "part_number": 1,
      "content_md5": "AAAAAAAAAAAAAAAAAAAAAA=="
    }
  ]
}

Response

Code example
{
  "task_id": "00000000-0000-4000-8000-000000000001",
  "parts": [
    {
      "part_number": 1,
      "url": "https://uploads.example.com/opaque-signed-upload",
      "headers": {
        "content-length": "96044",
        "content-md5": "AAAAAAAAAAAAAAAAAAAAAA=="
      },
      "expires_in": 900
    }
  ]
}

Pricing and limits

50 credits reserved before the first upload URLs are issued, once per task. Use 8 MiB parts except the final part. Request up to 100 URLs at a time, valid for 15 minutes. Renewals and retries do not reserve credits again.

POST
Audio Cleaner · Get Upload Part URLsv1.0.0

Audio Cleaner · Complete Upload

Complete Upload using the published function and version.

Parameters

ParameterExample
task_id"00000000-0000-4000-8000-000000000001"

Request

Code example
{
  "task_id": "00000000-0000-4000-8000-000000000001"
}

Response

Code example
{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "operation": "analyze_audio",
    "status": "QUEUED",
    "file_name": "input.wav",
    "content_type": "audio/wav",
    "file_size": 96044,
    "created_at": "2027-01-01T00:00:00Z",
    "uploaded_at": "2027-01-01T00:01:00Z",
    "started_at": null,
    "ready_at": null,
    "result_expires_at": null,
    "released_at": null,
    "progress": 0,
    "error_code": null,
    "attempts": 0
  }
}

Pricing and limits

No additional request fee. Call after all parts are uploaded, using a stable idempotency key. The task enters the queue; successful processing is billed asynchronously.

POST
Audio Cleaner · Complete Uploadv1.0.0

Explicitly request result download links and release the lifecycle slot. This does not automatically download or play the result.

Parameters

ParameterExample
task_id"00000000-0000-4000-8000-000000000001"

Request

Code example
{
  "task_id": "00000000-0000-4000-8000-000000000001"
}

Response

Code example
{
  "task_id": "00000000-0000-4000-8000-000000000001",
  "status": "COMPLETED",
  "links": [
    {
      "artifact_id": "00000000-0000-4000-8000-000000000001",
      "role": "analysis",
      "expires_at": "2027-01-01T00:20:00Z",
      "remaining_gets": 3,
      "url": "https://files.example.com/opaque-download"
    }
  ]
}

Pricing and limits

No additional request fee. Explicitly requesting links releases the lifecycle slot. Each file allows three GET requests; a Range request counts as one GET, while HEAD is free. Renewing links does not reset the count.

POST
Audio Cleaner · Get Result Download Linksv1.0.0

Tasks

Audio Cleaner · Denoise Audio

Denoise Audio using the published function and version.

Parameters

ParameterExample
file_name"input.wav"
content_type"audio/wav"
file_size_bytes96044

Request

Code example
{
  "file_name": "input.wav",
  "content_type": "audio/wav",
  "file_size_bytes": 96044
}

Response

Code example
{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "operation": "denoise_audio",
    "status": "UPLOADING",
    "file_name": "input.wav",
    "content_type": "audio/wav",
    "file_size": 96044,
    "created_at": "2027-01-01T00:00:00Z",
    "uploaded_at": null,
    "started_at": null,
    "ready_at": null,
    "result_expires_at": null,
    "released_at": null,
    "progress": 0,
    "error_code": null,
    "attempts": 0
  },
  "part_size_bytes": 8388608,
  "part_count": 1,
  "upload_expires_at": "2027-01-01T12:00:00Z"
}

Pricing and limits

50 credits per rounded-up minute of the selected complete input audio track. Inputs: up to 1 GiB, 3 seconds to 24 hours, and 1/2/6/8 channels. The file extension, Content-Type, and verified container must agree.

POST
Audio Cleaner · Denoise Audiov1.0.0

Audio Cleaner · Denoise Video

Denoise Video using the published function and version.

Parameters

ParameterExample
file_name"input.mp4"
content_type"video/mp4"
file_size_bytes96044

Request

Code example
{
  "file_name": "input.mp4",
  "content_type": "video/mp4",
  "file_size_bytes": 96044
}

Response

Code example
{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "operation": "denoise_video",
    "status": "UPLOADING",
    "file_name": "input.wav",
    "content_type": "audio/wav",
    "file_size": 96044,
    "created_at": "2027-01-01T00:00:00Z",
    "uploaded_at": null,
    "started_at": null,
    "ready_at": null,
    "result_expires_at": null,
    "released_at": null,
    "progress": 0,
    "error_code": null,
    "attempts": 0
  },
  "part_size_bytes": 8388608,
  "part_count": 1,
  "upload_expires_at": "2027-01-01T12:00:00Z"
}

Pricing and limits

50 credits per rounded-up minute of the selected complete input audio track. Inputs: up to 1 GiB, 3 seconds to 24 hours, and 1/2/6/8 channels. The file extension, Content-Type, and verified container must agree.

POST
Audio Cleaner · Denoise Videov1.0.0

Audio Cleaner · Inspect Media

Inspect Media using the published function and version.

Parameters

ParameterExample
file_name"input.wav"
content_type"audio/wav"
file_size_bytes96044

Request

Code example
{
  "file_name": "input.wav",
  "content_type": "audio/wav",
  "file_size_bytes": 96044
}

Response

Code example
{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "operation": "inspect_media",
    "status": "UPLOADING",
    "file_name": "input.wav",
    "content_type": "audio/wav",
    "file_size": 96044,
    "created_at": "2027-01-01T00:00:00Z",
    "uploaded_at": null,
    "started_at": null,
    "ready_at": null,
    "result_expires_at": null,
    "released_at": null,
    "progress": 0,
    "error_code": null,
    "attempts": 0
  },
  "part_size_bytes": 8388608,
  "part_count": 1,
  "upload_expires_at": "2027-01-01T12:00:00Z"
}

Pricing and limits

10 credits per successful inspection. Inputs: up to 1 GiB, 3 seconds to 24 hours, and 1/2/6/8 channels. The file extension, Content-Type, and verified container must agree.

POST
Audio Cleaner · Inspect Mediav1.0.0

Audio Cleaner · Analyze Audio

Analyze Audio using the published function and version.

Parameters

ParameterExample
file_name"input.wav"
content_type"audio/wav"
file_size_bytes96044

Request

Code example
{
  "file_name": "input.wav",
  "content_type": "audio/wav",
  "file_size_bytes": 96044
}

Response

Code example
{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "operation": "analyze_audio",
    "status": "UPLOADING",
    "file_name": "input.wav",
    "content_type": "audio/wav",
    "file_size": 96044,
    "created_at": "2027-01-01T00:00:00Z",
    "uploaded_at": null,
    "started_at": null,
    "ready_at": null,
    "result_expires_at": null,
    "released_at": null,
    "progress": 0,
    "error_code": null,
    "attempts": 0
  },
  "part_size_bytes": 8388608,
  "part_count": 1,
  "upload_expires_at": "2027-01-01T12:00:00Z"
}

Pricing and limits

15 credits per channel-minute. Inputs: up to 1 GiB, 3 seconds to 24 hours, and 1/2/6/8 channels. The file extension, Content-Type, and verified container must agree.

POST
Audio Cleaner · Analyze Audiov1.0.0

Audio Cleaner · Generate Waveform

Generate Waveform using the published function and version.

Parameters

ParameterExample
file_name"input.wav"
content_type"audio/wav"
file_size_bytes96044

Request

Code example
{
  "file_name": "input.wav",
  "content_type": "audio/wav",
  "file_size_bytes": 96044
}

Response

Code example
{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "operation": "generate_waveform",
    "status": "UPLOADING",
    "file_name": "input.wav",
    "content_type": "audio/wav",
    "file_size": 96044,
    "created_at": "2027-01-01T00:00:00Z",
    "uploaded_at": null,
    "started_at": null,
    "ready_at": null,
    "result_expires_at": null,
    "released_at": null,
    "progress": 0,
    "error_code": null,
    "attempts": 0
  },
  "part_size_bytes": 8388608,
  "part_count": 1,
  "upload_expires_at": "2027-01-01T12:00:00Z"
}

Pricing and limits

10 credits per channel-minute. Inputs: up to 1 GiB, 3 seconds to 24 hours, and 1/2/6/8 channels. The file extension, Content-Type, and verified container must agree.

POST
Audio Cleaner · Generate Waveformv1.0.0

Audio Cleaner · Get Task

Get Task using the published function and version.

Parameters

ParameterExample
Query parameterstask_id

Request

Code example
{}

Response

Code example
{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "operation": "analyze_audio",
    "status": "READY",
    "file_name": "input.wav",
    "content_type": "audio/wav",
    "file_size": 96044,
    "created_at": "2027-01-01T00:00:00Z",
    "uploaded_at": "2027-01-01T00:01:00Z",
    "started_at": "2027-01-01T00:02:00Z",
    "ready_at": "2027-01-01T00:03:00Z",
    "result_expires_at": "2027-01-02T00:03:00Z",
    "released_at": null,
    "progress": 100,
    "error_code": null,
    "attempts": 1
  },
  "usage": {
    "duration_seconds": "61",
    "channels": 2,
    "billable_minutes": 2,
    "billable_channel_minutes": 4
  },
  "artifacts": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "role": "analysis",
      "file_name": "analysis.json",
      "content_type": "application/json",
      "size": 128,
      "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "expires_at": "2027-01-02T00:03:00Z",
      "downloads_used": 0,
      "available": true
    }
  ]
}

Pricing and limits

No additional request fee. Checking a task does not claim its results or affect asynchronous settlement. usage is null before success.

GET
Audio Cleaner · Get Taskv1.0.0

Audio Cleaner · List Tasks

List Tasks using the published function and version.

Parameters

ParameterExample
Query parametersstatus, limit, cursor

Request

Code example
{}

Response

Code example
{
  "tasks": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "operation": "analyze_audio",
      "status": "UPLOADING",
      "file_name": "input.wav",
      "content_type": "audio/wav",
      "file_size": 96044,
      "created_at": "2027-01-01T00:00:00Z",
      "uploaded_at": null,
      "started_at": null,
      "ready_at": null,
      "result_expires_at": null,
      "released_at": null,
      "progress": 0,
      "error_code": null,
      "attempts": 0
    }
  ],
  "next_cursor": null
}

Pricing and limits

No additional request fee. Continue with the returned cursor, up to 50 tasks per page. Only tasks belonging to the current account are returned.

GET
Audio Cleaner · List Tasksv1.0.0

Audio Cleaner · Cancel Task

Cancel Task using the published function and version.

Parameters

ParameterExample
task_id"00000000-0000-4000-8000-000000000001"

Request

Code example
{
  "task_id": "00000000-0000-4000-8000-000000000001"
}

Response

Code example
{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "operation": "analyze_audio",
    "status": "CANCELED",
    "file_name": "input.wav",
    "content_type": "audio/wav",
    "file_size": 96044,
    "created_at": "2027-01-01T00:00:00Z",
    "uploaded_at": null,
    "started_at": null,
    "ready_at": null,
    "result_expires_at": null,
    "released_at": "2027-01-01T00:01:00Z",
    "progress": 0,
    "error_code": null,
    "attempts": 0
  }
}

Pricing and limits

No additional request fee. Only UPLOADING or QUEUED tasks whose processing has not started can be canceled; processing may win the race. Closing the drawer does not cancel a task.

POST
Audio Cleaner · Cancel Taskv1.0.0

Concurrency

Audio Cleaner · Get Concurrency Slots

Get Concurrency Slots using the published function and version.

Parameters

ParameterExample
Query parametersNone

Request

Code example
{}

Response

Code example
{
  "base_limit": 1,
  "additional_slots": 0,
  "limit": 1,
  "used": 0,
  "available": 1,
  "over_limit": false,
  "server_time": "2027-01-01T00:00:00Z",
  "grants": []
}

Pricing and limits

No additional request fee. Slots cover the full task lifecycle, including unclaimed READY results. Expiring temporary slots does not terminate existing tasks.

GET
Audio Cleaner · Get Concurrency Slotsv1.0.0

Audio Cleaner · Purchase Temporary Slots

Pay for temporary slots immediately, with optional scheduled activation. Each step is exactly 24 hours.

Parameters

ParameterExample
additional_slots1
duration_steps1

Request

Code example
{
  "additional_slots": 1,
  "duration_steps": 1
}

Response

Code example
{
  "id": "00000000-0000-4000-8000-000000000001",
  "additional_slots": 1,
  "starts_at": "2027-01-01T00:00:00Z",
  "expires_at": "2027-01-02T00:00:00Z",
  "status": "ACTIVE",
  "concurrency": {
    "base_limit": 1,
    "additional_slots": 1,
    "limit": 2,
    "used": 0,
    "available": 2,
    "over_limit": false,
    "server_time": "2027-01-01T00:00:00Z",
    "grants": [
      {
        "id": "00000000-0000-4000-8000-000000000001",
        "additional_slots": 1,
        "starts_at": "2027-01-01T00:00:00Z",
        "expires_at": "2027-01-02T00:00:00Z",
        "status": "ACTIVE"
      }
    ]
  }
}

Pricing and limits

additional_slots × duration_steps × 10000 credits, paid in full when the request succeeds. additional_slots must be a positive integer and duration_steps must be 1–3650. An optional starts_at must be a future timestamp with a timezone; if omitted, the server time when the request succeeds is used. Each step is 24 hours. Reuse the original idempotency key for retries.

POST
Audio Cleaner · Purchase Temporary Slotsv1.0.0

Skill

Audio Cleaner · Get Capabilities and Limits

Get Capabilities and Limits using the published function and version.

Parameters

ParameterExample
Query parametersNone

Request

Code example
{}

Response

Code example
{
  "operations": [
    "denoise_audio",
    "denoise_video",
    "inspect_media",
    "analyze_audio",
    "generate_waveform"
  ],
  "max_upload_bytes": 1073741824,
  "minimum_duration_seconds": 3,
  "maximum_duration_seconds": 86400,
  "part_size_bytes": 8388608,
  "upload_url_ttl_seconds": 900,
  "source_retention_seconds": 43200,
  "result_retention_seconds": 86400,
  "download_ticket_ttl_seconds": 900,
  "max_download_gets": 3,
  "accepted_formats": {
    "wav": [
      "audio/wav",
      "audio/x-wav"
    ],
    "mp3": [
      "audio/mpeg"
    ],
    "flac": [
      "audio/flac"
    ],
    "m4a": [
      "audio/mp4"
    ],
    "mp4": [
      "video/mp4"
    ],
    "mov": [
      "video/quicktime"
    ],
    "webm": [
      "video/webm"
    ]
  },
  "accepted_channel_layouts": [
    "MONO",
    "STEREO",
    "SURROUND_5_1_SIDE",
    "SURROUND_7_1"
  ],
  "mp3_channel_layouts": [
    "MONO",
    "STEREO"
  ],
  "waveform_points": 600
}

Pricing and limits

No additional request fee. No parameters are required. Returns publicly supported capabilities and limits.

GET
Audio Cleaner · Get Capabilities and Limitsv1.0.0

Complete guide and examples

Install the Skill · Complete guide · Python workflow example · Verification checklist

Closing Try or stopping polling does not cancel a task. Successful tasks settle independently of polling. Result links must be requested explicitly. Each result allows three GET requests; a Range request counts as one, and HEAD is free.