---
name: audio-cleaner
description: Use Audio Cleaner on API Basket to reduce background noise in audio or video, inspect media, analyze audio technical metrics, or generate a waveform. Handles multipart uploads, resumable asynchronous tasks, usage, explicit result claiming, checksummed downloads and temporary concurrency slots.
---

# Audio Cleaner

Use the published Audio Cleaner API and its fixed functions. Obtain the API Key from the user’s configured environment; never print it or save it in task state. Read [the calling guide](references/guide.md) before issuing requests and use [the complete Python client](scripts/audio_cleaner.py) for a resumable workflow. Read [the checklist](references/checklist.md) before completing a task.

Choose one of five operations: `denoise_audio`, `denoise_video`, `inspect_media`, `analyze_audio`, `generate_waveform`. Each has its own create function. The operation cannot be overridden in a request body.

Creating a task is free and occupies a lifecycle slot. Before requesting the first upload credentials, explain the one-time 50 credit reservation and the successful processing rate, and obtain the user’s authorization to spend. Reuse the same task and stable idempotency keys after a timeout. A successful task returns the entire reservation to its original credit source and expiry, then charges its full successful processing fee from current credits. Success can create an amount owed. Cancelled, expired and invalid-input tasks retain a paid reservation. A service failure returns it; uncertain failures await review. Unpaid tasks cost zero. A result expiring after success does not alter its bill.

Poll the task without claiming its result automatically. Claim download credentials only when the user requests the result: claiming releases the lifecycle slot. Download only when requested and verify SHA-256 against the artifact metadata. Each GET, including a Range request, consumes one of three allowed GETs per artifact. HEAD is free. Closing a UI or stopping polling does not cancel a task. Cancellation is allowed only before processing starts.

Temporary slots cost `additional_slots × duration_steps × 10000` credits immediately, including scheduled purchases. Each step is 24 hours. Explain the exact total and obtain spending authorization before purchase. Do not retry a purchase with a new idempotency key when the outcome is unknown.

Keep signed upload/download URLs and tickets private. Do not include them in logs, screenshots, summaries or saved state. Report the task ID, state, verified usage, price and verified local results.
