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

# Multilingual Support

> Multi-language support for ambient sessions and clinical documentation

<div className="quick-summary-wrapper">
  <div className="quick-summary-header">
    <span className="quick-summary-icon" aria-hidden="true" />

    <span className="quick-summary-title">Quick summary</span>
  </div>

  <div className="quick-summary-content">
    Multilingual support lets patients and providers speak in their preferred language during clinical conversations, while Suki automatically generates the final clinical note in English.
  </div>

  <div className="quick-summary-footer">
    <span className="quick-summary-footer-icon" aria-hidden="true" />

    <span className="quick-summary-footer-text">Last updated:</span>
    <span className="quick-summary-footer-date">June 2026</span>
  </div>
</div>

<Info>
  **Multilingual support is supported by:** Ambient APIs, Mobile SDK, Web SDK (v2.1.1+)
</Info>

Multilingual support lets patients and <Tooltip tip="A healthcare professional within an organization who uses Suki's services to document patient care." cta="View in Glossary" href="/Glossary/p">providers</Tooltip> speak in their preferred language during clinical conversations, while Suki automatically generates the final <Tooltip tip="The final structured medical documentation generated from a patient encounter, organized into standardized sections using LOINC codes." cta="View in Glossary" href="/Glossary/c">clinical note</Tooltip> in English. This removes the need for manual translation and makes healthcare more accessible to diverse patient populations.

When you enable multilingual support for an <Tooltip tip="A single, time-bound instance of an ambient recording for a specific patient encounter that captures clinical conversations." cta="View in Glossary" href="/Glossary/a">ambient session</Tooltip>, you get the following benefits:

* **Patient comfort**: Patients can communicate in their native language, leading to more accurate information sharing
* **Better care quality**: When patients speak in their preferred language, they provide more detailed and accurate information
* **No translation needed**: Clinicians don't need to translate conversations manually, Suki handles it automatically
* **EHR compatibility**: All notes are generated in English, ensuring compatibility with standard <Tooltip tip="Electronic Health Record. A digital version of a patient's paper chart containing comprehensive health information." cta="View in Glossary" href="/Glossary/e">EHR</Tooltip> systems
* **Wider accessibility**: Support for 80+ languages makes healthcare more inclusive

## How it works

When you enable multilingual support for an ambient session, Suki automatically:

1. **Detects the language** spoken during the conversation
2. **Transcribes the audio** in the detected language
3. **Translates and processes** the conversation content
4. **Generates the clinical note** in English

The <Tooltip tip="The text version of recorded audio from clinical conversations, generated by automatic speech recognition." cta="View in Glossary" href="/Glossary/t">transcript</Tooltip> API returns a `lang_id` field that identifies which language was detected for each segment of the conversation. This helps you understand what language was spoken during different parts of the session.

## How to enable multilingual support

Enable multilingual support when creating an ambient session. The exact method depends on whether you're using the Mobile SDK or APIs.

**Mobile SDK Example:**

```swift Swift theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
let sessionContext = [
    SukiAmbientConstant.kSessionId: encounterId,
    SukiAmbientConstant.kMultilingual: true // Enable multilingual support
] as [String : AnyHashable]

SukiAmbientCoreManager.shared.createSession(
    with: sessionContext,
    onCompletion: { result in
        switch result {
        case .success(let sessionResponse):
            let sessionId = sessionResponse.sessionId
            // Store sessionId for future use
        case .failure(let error):
            // Handle error
        }
    }
)
```

**API Example:**

```python Python theme={"theme":{"light":"github-dark","dark":"material-theme-darker"}}
payload = {
    "ambient_session_id": "123dfg-456dfg-789dfg-012dfg",  # Optional
    "encounter_id": "123dfg-456dfg-789dfg-012dfg",  # Optional
    "multilingual": false  # [!code --] Deprecated in v1.1.1
}

response = requests.post(
    "https://sdp.suki-stage.com/api/v1/ambient/session/create",
    json=payload,
    headers={"sdp_suki_token": "<sdp_suki_token>", "sdp_provider_id": "<sdp_provider_id>"}
)
```

For complete API documentation, see the [Create ambient session API](/api-reference/ambient-sessions/create).

<Note>
  Multilingual support is **enabled by default** for all ambient sessions

  The `multilingual` parameter is deprecated. You no longer need to pass it when creating a session. Once active, it applies to the entire session and cannot be changed mid-session.
</Note>

## Supported languages

Suki supports over **80 languages** for ambient sessions. The following languages are currently supported:

|                     |                    |             |               |           |
| ------------------- | ------------------ | ----------- | ------------- | --------- |
| Spanish             | Norwegian          | Macedonian  | Kazakh        | Yoruba    |
| Italian             | Finnish            | Hungarian   | Icelandic     | Telugu    |
| English             | Vietnamese         | Tamil       | Marathi       | Khmer     |
| Portuguese          | Thai               | Hindi       | Maori         | Malayalam |
| German              | Slovak             | Estonian    | Swahili       | Lao       |
| Japanese            | Greek              | Urdu        | Armenian      | Punjabi   |
| Polish              | Czech              | Latvian     | Belarusian    | Gujarati  |
| Russian             | Croatian           | Slovenian   | Nepali        | Somali    |
| Dutch               | Danish             | Azerbaijani | Occitan       | Bengali   |
| Indonesian          | Tagalog            | Hebrew      | Lingala       | Georgian  |
| Catalan             | Korean             | Lithuanian  | Maltese       | Assamese  |
| French              | Romanian           | Persian     | Tajik         | Mongolian |
| Turkish             | Bulgarian          | Welsh       | Luxembourgish | Myanmar   |
| Swedish             | Galician           | Serbian     | Hausa         | Shona     |
| Ukrainian           | Bosnian            | Afrikaans   | Uzbek         | Amharic   |
| Malay               | Arabic             | Kannada     | Pashto        | Sindhi    |
| Chinese (Cantonese) | Chinese (Mandarin) |             |               |           |

## Language code reference

Pick a **Letter** below to show languages starting with that letter, then use the table to map each `lang_id` to its corresponding language. This helps you interpret the language codes returned by the Transcript API.

<Note>
  We regularly update this list as we add support for new languages. If a language is not included in this table, it is not yet supported.
</Note>

<div data-suki-multilingual-lang-root data-multilingual-lang-letter="A">
  <div data-suki-multilingual-lang-toolbar-mount aria-live="polite" />

  <div data-suki-multilingual-lang-panels>
    <section data-lang-letter="A">
      **A**

      | Language    | Language ID (`lang_id`) |
      | ----------- | ----------------------- |
      | afrikaans   | af                      |
      | amharic     | am                      |
      | arabic      | ar                      |
      | armenian    | hy                      |
      | assamese    | as                      |
      | azerbaijani | az                      |
    </section>

    <section data-lang-letter="B">
      **B**

      | Language   | Language ID (`lang_id`) |
      | ---------- | ----------------------- |
      | belarusian | be                      |
      | bengali    | bn                      |
      | bosnian    | bs                      |
      | bulgarian  | bg                      |
    </section>

    <section data-lang-letter="C">
      **C**

      | Language           | Language ID (`lang_id`) |
      | ------------------ | ----------------------- |
      | catalan            | ca                      |
      | chinese            | zh                      |
      | chinese\_cantonese | yue                     |
      | chinese\_mandarin  | cmn                     |
      | croatian           | hr                      |
      | czech              | cs                      |
    </section>

    <section data-lang-letter="D">
      **D**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | danish   | da                      |
      | dutch    | nl                      |
    </section>

    <section data-lang-letter="E">
      **E**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | english  | en                      |
      | estonian | et                      |
    </section>

    <section data-lang-letter="F">
      **F**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | finnish  | fi                      |
      | french   | fr                      |
    </section>

    <section data-lang-letter="G">
      **G**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | galician | gl                      |
      | georgian | ka                      |
      | german   | de                      |
      | greek    | el                      |
      | gujarati | gu                      |
    </section>

    <section data-lang-letter="H">
      **H**

      | Language  | Language ID (`lang_id`) |
      | --------- | ----------------------- |
      | hausa     | ha                      |
      | hebrew    | he                      |
      | hindi     | hi                      |
      | hungarian | hu                      |
    </section>

    <section data-lang-letter="I">
      **I**

      | Language   | Language ID (`lang_id`) |
      | ---------- | ----------------------- |
      | icelandic  | is                      |
      | indonesian | id                      |
      | italian    | it                      |
    </section>

    <section data-lang-letter="J">
      **J**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | japanese | ja                      |
    </section>

    <section data-lang-letter="K">
      **K**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | kannada  | kn                      |
      | kazakh   | kk                      |
      | khmer    | km                      |
      | korean   | ko                      |
    </section>

    <section data-lang-letter="L">
      **L**

      | Language      | Language ID (`lang_id`) |
      | ------------- | ----------------------- |
      | lao           | lo                      |
      | latvian       | lv                      |
      | lingala       | ln                      |
      | lithuanian    | lt                      |
      | luxembourgish | lb                      |
    </section>

    <section data-lang-letter="M">
      **M**

      | Language   | Language ID (`lang_id`) |
      | ---------- | ----------------------- |
      | macedonian | mk                      |
      | malay      | ms                      |
      | malayalam  | ml                      |
      | maltese    | mt                      |
      | maori      | mi                      |
      | marathi    | mr                      |
      | mongolian  | mn                      |
      | myanmar    | my                      |
    </section>

    <section data-lang-letter="N">
      **N**

      | Language  | Language ID (`lang_id`) |
      | --------- | ----------------------- |
      | nepali    | ne                      |
      | norwegian | no                      |
    </section>

    <section data-lang-letter="O">
      **O**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | occitan  | oc                      |
    </section>

    <section data-lang-letter="P">
      **P**

      | Language   | Language ID (`lang_id`) |
      | ---------- | ----------------------- |
      | pashto     | ps                      |
      | persian    | fa                      |
      | polish     | pl                      |
      | portuguese | pt                      |
      | punjabi    | pa                      |
    </section>

    <section data-lang-letter="R">
      **R**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | romanian | ro                      |
      | russian  | ru                      |
    </section>

    <section data-lang-letter="S">
      **S**

      | Language  | Language ID (`lang_id`) |
      | --------- | ----------------------- |
      | serbian   | sr                      |
      | shona     | sn                      |
      | sindhi    | sd                      |
      | slovak    | sk                      |
      | slovenian | sl                      |
      | somali    | so                      |
      | spanish   | es                      |
      | swahili   | sw                      |
      | swedish   | sv                      |
    </section>

    <section data-lang-letter="T">
      **T**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | tagalog  | tl                      |
      | tajik    | tg                      |
      | tamil    | ta                      |
      | telugu   | te                      |
      | thai     | th                      |
      | turkish  | tr                      |
    </section>

    <section data-lang-letter="U">
      **U**

      | Language  | Language ID (`lang_id`) |
      | --------- | ----------------------- |
      | ukrainian | uk                      |
      | urdu      | ur                      |
      | uzbek     | uz                      |
    </section>

    <section data-lang-letter="V">
      **V**

      | Language   | Language ID (`lang_id`) |
      | ---------- | ----------------------- |
      | vietnamese | vi                      |
    </section>

    <section data-lang-letter="W">
      **W**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | welsh    | cy                      |
    </section>

    <section data-lang-letter="Y">
      **Y**

      | Language | Language ID (`lang_id`) |
      | -------- | ----------------------- |
      | yoruba   | yo                      |
    </section>
  </div>
</div>

## Best practices

<Tip>
  * **Enable when needed**: Only enable multilingual support when you expect conversations in multiple languages. This optimizes performance.
  * **Set patient language preference**: If you know the patient's preferred language, you can display this information in your UI to help providers prepare.
  * **Monitor language detection**: Use the `lang_id` from transcripts to understand language usage patterns in your application.
  * **Test with your languages**: Verify multilingual support works correctly with the languages your patients commonly use.
  * **Note language in UI**: Consider displaying the detected language in your UI so providers know what language was spoken.
</Tip>

## Related APIs

Use these APIs to work with multilingual support:

<CardGroup cols={2}>
  <Card title="Get Session Transcript" icon="code" arrow={true} href="/api-reference/ambient-content/transcript">
    Retrieve transcripts with language detection information (`lang_id`)
  </Card>

  <Card title="Create Session" icon="code" arrow={true} href="/api-reference/audio-transcription/create-session">
    Create ambient sessions with multilingual support enabled
  </Card>
</CardGroup>