Aicoustics

ai-coustics is an acoustic noise cancellation denoiser. Like Sanas, it runs server-side over the Zero Runtime inference gateway (so it needs a gateway auth token), unlike the local RNNoise plugin. It occupies the pipeline’s denoise slot, cleaning the caller’s audio before the rest of the pipeline runs.

Setup

The denoiser connects to the inference gateway using your Zero Runtime auth token:

export ZERORUNTIME_AUTH_TOKEN=<token>

The token can also be passed explicitly to the factory.

Usage

Build the denoiser with AICousticsDenoise and pass it to the pipeline’s denoise slot.

from zeroruntime.inference import AICousticsDenoise

denoise = AICousticsDenoise(model_id="sparrow-xxs-48khz")

# Pipeline(denoise=denoise, ...)

import { AICousticsDenoise } from '@zeroruntime/js-sdk/inference';

const denoise = AICousticsDenoise({ model_id: 'sparrow-xxs-48khz' });

// Pipeline({ denoise, ... })

Models

ai-coustics offers two model families:

Family	Use case	Sample rate	Examples
Sparrow	Human-to-human audio	48 kHz	`sparrow-xxs-48khz` (fastest), `sparrow-s-48khz`, `sparrow-l-48khz` (best quality)
Quail	Human-to-machine (voice AI / STT)	16 kHz	`quail-vf-l-16khz`, `quail-l-16khz`, `quail-s-16khz`

Match sample_rate to the model family (48000 for Sparrow, 16000 for Quail).

Parameters

Parameters for AICousticsDenoise.

Parameter	Type	Default	Description
`model_id`	`str`	`"rook-l-48khz"`	ai-coustics model.
`sample_rate`	`int`	`48000`	Audio sample rate (Hz). Use `16000` for Quail models.
`base_url`	`str`	`None`	Override the inference gateway URL.

Import paths

SDK	Import	Constructor
Python	`from zeroruntime.inference import AICousticsDenoise`	`AICousticsDenoise(...)`
Node JS	`import { AICousticsDenoise } from '@zeroruntime/js-sdk/inference'`	`AICousticsDenoise({ ... })`

Noise cancellation runs first, so voice activity detection and speech-to-text see cleaner audio.

Plugins

Inference Gateway

Speech-to-text

LLM

Text-to-speech

Realtime models

Avatars

Turn detection

Voice activity detection

Noise cancellation

Setup

Usage

Models

Parameters

Import paths

​Setup

​Usage

​Models

​Parameters

​Import paths

Setup

Usage

Models

Parameters

Import paths