지원 로케일

​

개요

SupportedLocale 값은 language_COUNTRY 패턴을 따라요. language는 소문자(ISO 639-1), COUNTRY는 대문자(ISO 3166-1 alpha-2)예요.

• 예시: en_US, ko_KR, ja_JP, zh_CN, es_ES, fr_FR
• transcribeLocale, translateLocale, summaryLocale 같은 필드에서 사용돼요.

​

지원 목록

SupportedLocale enum 값은 아래 목록뿐이에요. auto는 이 enum에 없는 값이에요. 자동 감지가 적용되는 곳은 Voice File Job 생성 요청(POST /v1/external/voice-file/jobs 계열)의 transcriptLocaleHints를 생략했을 때뿐이에요 — 생략하면 오디오에서 자동으로 감지하며, "auto"라는 문자열을 값으로 보내는 게 아니에요. 응답 필드인 transcribeLocale·translateLocale·summaryLocale은 요청 시 직접 지정하는 값이 아니라, 처리 후 실제 사용된 로케일을 보여주는 값이에요. 문서 생성(GenerateNoteDocumentRequest.locale)은 자동 감지를 지원하지 않으므로 아래 값 중 하나를 명시해야 해요.

• de_DE – 독일어 (독일)
• en_US – 영어 (미국)
• es_ES – 스페인어 (스페인)
• fr_FR – 프랑스어 (프랑스)
• hi_IN – 힌디어 (인도)
• id_ID – 인도네시아어 (인도네시아)
• it_IT – 이탈리아어 (이탈리아)
• ja_JP – 일본어 (일본)
• ko_KR – 한국어 (대한민국)
• ms_MY – 말레이어 (말레이시아)
• ru_RU – 러시아어 (러시아)
• sv_SE – 스웨덴어 (스웨덴)
• th_TH – 태국어 (태국)
• tr_TR – 터키어 (튀르키예)
• uk_UA – 우크라이나어 (우크라이나)
• vi_VN – 베트남어 (베트남)
• zh_CN – 중국어 (간체, 중국)

​

가이드라인

• transcribeLocale·translateLocale·summaryLocale은 응답에서 실제 사용된 로케일을 보여주는 읽기 전용 필드예요. 요청 시 로케일을 지정하는 파라미터가 아니에요.
• 요청에서 로케일을 지정하려면 각 엔드포인트가 정의한 필드를 쓰세요. 예를 들어 Voice File Job 생성 시에는 transcriptLocaleHints(생략하면 오디오에서 자동 감지), 문서 생성 시에는 GenerateNoteDocumentRequest.locale을 써요.