Skip to main content
Quick Summary
Multilingual support lets patients and providers speak in their preferred language during clinical conversations, while Suki automatically generates the final clinical note in English.
Multilingual support is supported for Mobile SDK and APIs only. The Web SDK and Headless Web SDK do not currently support multilingual sessions.

Overview

Multilingual support lets patients and providers speak in their preferred language during clinical conversations, while Suki automatically generates the final clinical note 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 ambient session, 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 EHR 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 transcript 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
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
payload = {
    "ambient_session_id": "123dfg-456dfg-789dfg-012dfg",  # Optional
    "encounter_id": "123dfg-456dfg-789dfg-012dfg",  # Optional
    "multilingual": True  # Enable multilingual support
}

response = requests.post(
    "https://sdp.suki.ai/api/v1/ambient/session/create",
    json=payload,
    headers={"sdp_suki_token": "<sdp_suki_token>"}
)
For complete API documentation, see the Create Ambient Session API.
Multilingual support is disabled by default.You must explicitly enable it when creating a session. Once enabled, it applies to the entire session and cannot be changed mid-session.

Supported Languages

Suki supports over 80 languages for ambient sessions. The following languages are currently supported:
SpanishNorwegianMacedonianKazakhYoruba
ItalianFinnishHungarianIcelandicTelugu
EnglishVietnameseTamilMarathiKhmer
PortugueseThaiHindiMaoriMalayalam
GermanSlovakEstonianSwahiliLao
JapaneseGreekUrduArmenianPunjabi
PolishCzechLatvianBelarusianGujarati
RussianCroatianSlovenianNepaliSomali
DutchDanishAzerbaijaniOccitanBengali
IndonesianTagalogHebrewLingalaGeorgian
CatalanKoreanLithuanianMalteseAssamese
FrenchRomanianPersianTajikMongolian
TurkishBulgarianWelshLuxembourgishMyanmar
SwedishGalicianSerbianHausaShona
UkrainianBosnianAfrikaansUzbekAmharic
MalayArabicKannadaPashtoSindhi
Chinese (Cantonese)Chinese (Mandarin)

Language Code Reference

Use the following table to map each lang_id to its corresponding language. This helps you interpret the language codes returned by the Transcript API.
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.
A
LanguageLanguage ID (lang_id)
afrikaansaf
amharicam
arabicar
armenianhy
assameseas
azerbaijaniaz
B
LanguageLanguage ID (lang_id)
belarusianbe
bengalibn
bosnianbs
bulgarianbg
C
LanguageLanguage ID (lang_id)
catalanca
chinesezh
chinese_cantoneseyue
chinese_mandarincmn
croatianhr
czechcs
D
LanguageLanguage ID (lang_id)
danishda
dutchnl
E
LanguageLanguage ID (lang_id)
englishen
estonianet
F
LanguageLanguage ID (lang_id)
finnishfi
frenchfr
G
LanguageLanguage ID (lang_id)
galiciangl
georgianka
germande
greekel
gujaratigu
H
LanguageLanguage ID (lang_id)
hausaha
hebrewhe
hindihi
hungarianhu
I
LanguageLanguage ID (lang_id)
icelandicis
indonesianid
italianit
J
LanguageLanguage ID (lang_id)
japaneseja
K
LanguageLanguage ID (lang_id)
kannadakn
kazakhkk
khmerkm
koreanko
L
LanguageLanguage ID (lang_id)
laolo
latvianlv
lingalaln
lithuanianlt
luxembourgishlb
M
LanguageLanguage ID (lang_id)
macedonianmk
malayms
malayalamml
maltesemt
maorimi
marathimr
mongolianmn
myanmarmy
N
LanguageLanguage ID (lang_id)
nepaline
norwegianno
O
LanguageLanguage ID (lang_id)
occitanoc
P
LanguageLanguage ID (lang_id)
pashtops
persianfa
polishpl
portuguesept
punjabipa
R
LanguageLanguage ID (lang_id)
romanianro
russianru
S
LanguageLanguage ID (lang_id)
serbiansr
shonasn
sindhisd
slovaksk
sloveniansl
somaliso
spanishes
swahilisw
swedishsv
T
LanguageLanguage ID (lang_id)
tagalogtl
tajiktg
tamilta
telugute
thaith
turkishtr
U
LanguageLanguage ID (lang_id)
ukrainianuk
urduur
uzbekuz
V
LanguageLanguage ID (lang_id)
vietnamesevi
W
LanguageLanguage ID (lang_id)
welshcy
Y
LanguageLanguage ID (lang_id)
yorubayo

Best Practices

  • 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.
Use these APIs to work with multilingual support: