> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sanas.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# C++ SDK Overview

> Real-time access to the Sanas cloud speech platform from a C++17 application

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.

<Note>This SDK is the C++ counterpart of the [Python SDK](/API-Reference/Overview). 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.</Note>

## 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.      |

<Note>**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`).</Note>

### 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

<CardGroup cols={2}>
  <Card title="Installation & Linking" icon="download" href="/API-Reference/Cpp-SDK/Guides/Installation">
    Compile and link against the SDK on Linux, macOS, or Windows.
  </Card>

  <Card title="Quick Start" icon="rocket" href="/API-Reference/Cpp-SDK/Guides/Quick-Start">
    A complete end-to-end Language Translation program.
  </Card>

  <Card title="Configuration Reference" icon="sliders" href="/API-Reference/Cpp-SDK/Reference/Configuration">
    InitParams, AudioParams, LanguageConfig, and JitterParams.
  </Card>

  <Card title="Glossary" icon="book-bookmark" href="/API-Reference/Cpp-SDK/Glossary">
    Definitions of SDK terms and concepts.
  </Card>
</CardGroup>