C++ SDK Overview - Sanas Developer Hub

The Sanas Speech AI SDK is a C++ library that gives your application real-time access to the Sanas cloud speech processing platform. You stream audio in, processed audio comes back — along with optional live transcripts.

This SDK is the C++ counterpart of the Python SDK. It exposes the same class surface (IRemoteSDK, IAudioProcessor, InitParams, AudioParams, ProcessorState, and the result-code enums). This guide uses Language Translation as its worked example throughout, but the core integration pattern — lifecycle, audio format, state handling — is identical for all processing modes.

What the SDK supports

The SDK is a generic processing interface. Depending on your account entitlements (subscription plan), the same API can power three distinct processing modes:

Processing mode	Use case	How to configure
Language Translation	Real-time speech-to-speech translation between languages. Delivers translated audio and live transcripts in both source and target languages.	`AudioParams::WithLanguages(src, tgt, rate)`
Speech Enhancement	Reduces background noise and improves call clarity.	`AudioParams::WithModel("<model-key>", rate)`
Accent Translation	Standardises the accent of the speaker for improved intelligibility.	`AudioParams::WithModel("<model-key>", rate)`

What you get with Language Translation

Translated audio returned synchronously in the same call that sends the original audio.
Live transcript events for both the source language (what was spoken) and the target language (the translation), delivered asynchronously via callback.
The ability to switch source/target languages on an active stream without recreating the connection.

Key concepts

Four concepts cover everything you need to understand before writing your first integration.

Concept	Object	What it does
SDK	`IRemoteSDK`	The top-level object. Create one per process, initialise once, then use it to create audio processors.
Audio Processor	`IAudioProcessor`	Represents one live audio stream. Create one per concurrent call or session. Each processor runs independently.
Processor State	`ProcessorState`	Tracks the connection lifecycle: `kInitializing` → `kReady`. You may only send audio when the state is `kReady`.
Transcript Event	`TranscriptCallback`	JSON event delivered on a background thread, containing recognised source speech or translated target text.

One mode per processor. A processor is configured for exactly one processing mode — Language Translation or a named speech model. The mode is set at creation time and cannot be changed (though for LT you can switch the language pair on a live processor using UpdateLanguageConfig).

Architecture

Your application interacts only with the two SDK interfaces — IRemoteSDK and IAudioProcessor. All network communication, authentication, and processing is handled by the SDK and the Sanas cloud.

Your application  ──►  SDK layer (RemoteSdk)  ──►  Sanas cloud
   IRemoteSDK              network / auth            speech processing
   IAudioProcessor         media transport           translation + transcripts

SDK properties at a glance

Property	Value
Language / API	C++17, single public header `RemoteSDK.h`
Namespace	`sanas::remote`
Library	`RemoteSdk` (`.dll` / `.so` / `.dylib`)
Thread-safety	All SDK calls are thread-safe; multiple processors can run concurrently
Audio format	32-bit float, mono, 8 / 16 / 48 kHz

Next steps

Installation & Linking

Compile and link against the SDK on Linux, macOS, or Windows.

Quick Start

A complete end-to-end Language Translation program.

Configuration Reference

InitParams, AudioParams, LanguageConfig, and JitterParams.

Glossary

Definitions of SDK terms and concepts.

​What the SDK supports

​What you get with Language Translation

​Key concepts

​Architecture

​SDK properties at a glance

​Next steps

Installation & Linking

Quick Start

Configuration Reference

Glossary

What the SDK supports

What you get with Language Translation

Key concepts

Architecture

SDK properties at a glance

Next steps