아랍어, 영어, 스페인어 사용자를 위한 AI 기능은 코드베이스 하나를 공유하는 세 개의 제품입니다. 아랍어에서는 화면 방향이 뒤집혀야 합니다. 메시지 한 줄 안에 여러 문자 체계가 섞입니다. 숫자와 날짜는 지역마다 모양이 바뀝니다. 모델이 엉뚱한 언어로 답할 수 있고, 언어마다 비용도 다릅니다. 이 문제의 대부분은 하나의 설계 실수에서 나옵니다. “언어”를 하나의 설정으로 취급하는 것입니다.
이 글은 제품과 인터페이스 측면을 다룹니다. 앱 자체 문자열(플레이스홀더, 복수형, ICU 메시지) 번역은 LLM으로 앱 문자열을 아랍어로 번역하기에서, 프롬프트 작성법은 아랍어 프롬프트 엔지니어링에서 다룹니다.
인터페이스 로캘과 모델 언어를 왜 분리해야 하나요?
서로 다른 질문에 답하기 때문입니다. 인터페이스 로캘(ar-SA, en-US, es-MX)은 레이아웃 방향, 버튼의 언어, 숫자와 날짜의 표기를 결정합니다. 콘텐츠 언어는 특정 메시지, 문서, 녹음의 언어이며, 모델에게 무엇을 요청할지를 결정합니다.
둘은 수시로 갈라집니다. 아랍어 인터페이스를 쓰는 사우디 사용자가 영어 계약서를 붙여 넣습니다. 스페인어 사용자가 아랍어 청구서 사진을 올립니다. 두 언어를 쓰는 상담원이 대화 도중 언어를 바꿉니다(코드 스위칭). 인터페이스가 아랍어라는 이유로 코드가 “아랍어로 답하라”고 보내면, 영어 계약서에 아무도 원하지 않은 아랍어 요약이 붙습니다.
그러니 사용자별, 메시지별로 둘 다 저장하세요.
ui_locale: 사용자가 선택하며, 기본값은 브라우저 언어입니다.answer_language: 사용자가 명시적으로 고른 값이 있으면 그것을, 없으면 메시지에서 감지된 언어를 씁니다.- 오디오의 경우
audio_language: 전사 모델에 넘기는 값입니다. BroadNet의 API 레퍼런스는 전사 요청에 항상language를 보내라고 안내합니다. 그렇지 않으면 아랍어가 라틴 문자로 돌아올 수 있습니다.
오른쪽에서 왼쪽(RTL) 텍스트와 방향이 섞인 텍스트는 어떻게 지원하나요?
W3C 가이드에 따라 세 단계로 나눕니다.
- 로캘로 페이지 방향을 정합니다. 아랍어라면
html요소에dir="rtl"과lang="ar"을 지정합니다. W3C는 기본 방향을 CSS로 정하지 말고, 여백, 패딩, 정렬에는 left와 right 대신 논리값(start와end)을 쓰라고 안내합니다. - 논리 CSS를 씁니다.
margin-left대신margin-inline-start,left대신text-align: start를 씁니다. MDN은 논리 속성을 레이아웃을 “through logical rather than physical direction”(번역: 물리적 방향이 아닌 논리적 방향으로) 제어하는 것이라고 설명합니다. 그러면 스타일시트 하나로 두 방향을 모두 처리할 수 있습니다. - 직접 작성하지 않은 텍스트는 격리합니다. 사용자 메시지, 모델 답변, 제품명, 주문 코드는 각자 방향을 가집니다. W3C의 규칙은 이렇습니다. 실행 시 삽입되는 텍스트의 방향을 모른다면, 그 텍스트를 감싸는 요소에
dir="auto"를 추가하거나bdi요소로 감싸세요. 격리하지 않으면 아랍어 문장 끝의 영어 주문 코드가 반대쪽으로 튀고, 문장 부호가 이상한 위치에 붙습니다.
채팅 인터페이스라면 모든 메시지 말풍선에 dir="auto"를 지정하고(메시지마다 첫 번째 강한 방향 문자로 방향이 정해집니다), 자체 인터페이스 문자열 안의 이름과 코드는 bdi로 감쌉니다. 마크업이 없는 곳(푸시 알림, SMS, CSV 내보내기)에서는 유니코드 양방향 알고리즘의 격리 문자가 같은 역할을 합니다. 텍스트 앞에 U+2068 FIRST STRONG ISOLATE를, 뒤에 U+2069 POP DIRECTIONAL ISOLATE를 넣으세요.
모델 출력에는 경우가 하나 더 있습니다. 바로 Markdown입니다. 아랍어로 답하는 모델이 영어 코드, URL, 표 셀을 포함할 수 있습니다. 코드 블록은 명시적으로 dir="ltr"로 렌더링하고, 각 문단과 표 셀에는 dir="auto"를 지정하세요.
숫자와 날짜는 로캘에 따라 어떻게 달라야 하나요?
플랫폼에 형식화를 맡기고, 실제로 무엇이 출력되는지 테스트하세요. Node 24.22.1(ICU 78.3, CLDR 48)에서 1234.5와 2026년 11월 15일로 Intl.NumberFormat과 Intl.DateTimeFormat을 실행해 봤습니다.
| 로캘 | 숫자 | 날짜(long) | 방향 |
|---|---|---|---|
| en-US | 1,234.5 | November 15, 2026 | ltr |
| ar-SA | ١٬٢٣٤٫٥ | ١٥ نوفمبر ٢٠٢٦ | rtl |
| ar-SA-u-nu-latn | 1,234.5 | 15 نوفمبر 2026 | rtl |
| ar-AE | 1,234.5 | 15 نوفمبر 2026 | rtl |
| es-ES | 1234,5 | 15 de noviembre de 2026 | ltr |
| es-MX | 1,234.5 | 15 de noviembre de 2026 | ltr |
주목할 점이 네 가지 있습니다. 아랍어 로캘은 숫자가 다릅니다. 사우디는 기본이 아라비아-인도 숫자이고 UAE는 서양식 숫자이며, -u-nu-latn 확장(MDN의 numberingSystem 참고)을 붙이면 로캘을 서양식 숫자로 바꿀 수 있습니다. 스페인어는 지역에 따라 다릅니다. 스페인은 소수점에 쉼표를 쓰고 네 자리 숫자에는 천 단위 구분 기호를 넣지 않으며, 멕시코는 소수점에 마침표를 씁니다. 월 이름도 아랍권 안에서 다릅니다. ar-SA는 11월을 نوفمبر로, ar-MA는 نونبر로 출력했습니다. 그리고 브라우저는 각자의 ICU 버전을 탑재하므로, 대상 브라우저에서도 같은 검사를 돌려 보세요.
복수형은 CLDR 규칙을 따릅니다. ar의 Intl.PluralRules는 0, 1, 2, 3, 11, 100에 대해 여섯 가지 범주(zero, one, two, few, many, other)를 반환했지만, 영어와 스페인어는 같은 숫자에 대해 one과 other만 반환했습니다. 문자열 쪽 처리는 앱 문자열 글에 있습니다.
입력에서는 두 숫자 형식을 모두 받으세요. 사용자가 수량 필드에 ١٢٣٤를 입력할 수 있습니다. 파싱하기 전에 ASCII 숫자로 정규화하고, 프롬프트에서 숫자를 비교한다면 모델에 보내기 전에도 정규화하세요.
메시지마다 언어를 감지할 수 있나요?
일부는 가능합니다. 아랍 문자와 라틴 문자를 구분하는 일은 쉽고 믿을 만합니다. 아랍어 유니코드 블록의 문자 수를 세면 됩니다. 영어와 스페인어를 구분하거나 아주 짧은 메시지를 판별하려면 학습된 모델이 필요합니다. fastText는 176개 언어용 언어 식별 모델 두 개(lid.176.bin 126 MB, 압축판 lid.176.ftz 917 kB)를 공개하고 있습니다.
위의 결정들을 담은 작은 헬퍼 모듈입니다. 감지기는 단순한 방식이 어디서 실패하는지 보여 주려고 일부러 단순하게 만들었습니다.
// UI locale and content language are separate values. Never derive one from the other silently.
const RTL = new Set(['ar', 'he', 'fa', 'ur']);
/** Rough script-based guess: enough to pick a direction and a prompt, not a language-ID model. */
export function guessLanguage(text) {
const arabic = (text.match(/[-ۿݐ-ݿ]/g) || []).length;
const latin = (text.match(/[A-Za-zÀ-ÿ]/g) || []).length;
if (arabic + latin < 3) return 'und';
if (arabic / (arabic + latin) > 0.6) return 'ar';
if (arabic / (arabic + latin) > 0.2) return 'mixed';
return /[ñ¿¡áéíóú]|\b(el|la|los|las|de|que|por|para|está|dónde)\b/i.test(text) ? 'es' : 'en';
}
/** Wrap user or model text for display inside UI text of either direction (W3C: bdi / dir="auto"). */
export const isolate = (s) => `<bdi>${s.replace(/[&<>"]/g, (c) => ({ '&': '&', '<': '<', '>': '>', '"': '"' })[c])}</bdi>`;
/** Plain-text equivalent for places with no markup (notifications, CSV, SMS): FSI ... PDI. */
export const isolateText = (s) => `${s}`;
export function formatters(uiLocale) {
return {
dir: RTL.has(new Intl.Locale(uiLocale).language) ? 'rtl' : 'ltr',
number: new Intl.NumberFormat(uiLocale),
date: new Intl.DateTimeFormat(uiLocale, { dateStyle: 'long', timeZone: 'UTC' }),
plural: new Intl.PluralRules(uiLocale),
};
}
/** Normalise digits a user typed before parsing: Arabic-Indic and Persian to ASCII. */
export const toAsciiDigits = (s) =>
s.replace(/[٠-٩]/g, (d) => d.charCodeAt(0) - 0x0660).replace(/[۰-۹]/g, (d) => d.charCodeAt(0) - 0x06F0);
/** System prompt: the answer language comes from the content, or the user's explicit choice, not the UI. */
export function systemPrompt({ answerLanguage }) {
const name = { ar: 'Arabic', en: 'English', es: 'Spanish' }[answerLanguage] ?? 'the language of the user\'s message';
return `Answer in ${name}. Keep product names, code, URLs and numbers exactly as written.`;
}
Node 24에서 실행했습니다. وين طلبي؟는 ar, “¿Dónde está mi pedido?”는 es, “Where is my order?”는 en, 주문 코드 ORD-5521이 들어간 아랍어 문장은 ar로 판정했습니다. “ok”는 und가 나왔고, 프롬프트에서는 올바르게 “the language of the user’s message”(사용자 메시지의 언어)로 대체됩니다. 그리고 라틴 문자로 쓴 이집트 아랍어(아라비지)인 “ana 3ayez a3raf el order fen”은 “el”이라는 단어가 스페인어처럼 보여서 es가 나왔습니다. 휴리스틱으로서는 정직한 결과입니다. 사용자가 아라비지를 쓴다면 아라비지 처리하기에서처럼 이를 명시적으로 감지해 아랍어로 취급하고, 사용자가 탭 한 번으로 답변 언어를 바로잡을 수 있게 하세요.
숫자 헬퍼는 ٢٠٢٦-١١-١٥를 2026-11-15로 바꿨고, isolate()는 감싸기 전에 HTML을 이스케이프하므로 Acme <Ltd> 같은 회사명이 마크업을 주입할 수 없습니다.
언어가 바뀌면 그 밖에 무엇이 달라지나요?
- 텍스트 길이. 번역된 인터페이스 텍스트는 대개 더 깁니다. W3C는 IBM 가이드라인을 인용해, 10자 이하의 영어 문자열은 유럽 언어에서 원래 길이의 200~300%까지, 70자를 넘는 문자열은 약 130%까지 늘어난다고 봅니다. 버튼과 레이블은 줄바꿈되도록 설계하고, 스페인어 빌드는 좁은 너비에서 테스트하세요.
- 글꼴. 아랍어 디자인이 짝을 이루는 글꼴 패밀리를 고르고, 아랍어 줄 높이를 확인하세요. 발음 구별 기호에는 위아래 공간이 필요합니다.
- 검색과 매칭. 아랍어 텍스트는 매칭 전에 정규화가 필요합니다(발음 구별 기호, 알리프 형태, 타트윌). 아랍어 텍스트 정규화 도구에서 각 규칙을 볼 수 있습니다.
- 음성. 전사 모델은 인터페이스가 아니라 오디오의 언어로 고르세요. BroadNet은 아랍어 모델 하나와, 영어, 스페인어, 아랍어를 포함하는 14개 언어 모델 하나를 제공합니다. 다국어 모델 페이지는 아랍어 오디오에는 아랍어 모델을 고르라고 안내합니다. 선택지 비교는 다국어 음성 인식 글에 있습니다.
- 방언. “아랍어”는 하나의 대상이 아닙니다. 리야드, 카이로, 카사블랑카의 사용자는 글을 다르게 씁니다. 무엇을 테스트할지는 걸프·이집트 방언에서 다룹니다.
언어별 평가와 예산은 어떻게 잡나요?
따로따로 잡습니다. 하나로 합친 점수는 약한 언어를 가리고, 하나로 합친 예산은 비싼 언어를 가립니다.
실제 메시지로 언어별 소규모 평가 세트를 만들고, 원어민이 기대 답변에 레이블을 붙이게 하세요. 답변이 요청한 언어로 나오는지, 이름, 숫자, 코드가 그대로 유지되는지, 지원하는 방언마다 품질이 유지되는지 확인합니다. 모델이나 프롬프트를 바꿀 때마다 같은 세트를 돌리세요. 방법은 전환 전에 LLM 평가하기에 있습니다.
비용 측면에서 토큰 수는 언어와 토크나이저에 따라 다릅니다. BroadRouter의 측정 데이터셋에서 같은 현대 표준 아랍어(MSA) 텍스트는 영어 번역본 대비 1.31×(Qwen3.8 27B 모델)부터 1.77×(GLM 5.3 모델)까지의 토큰이 필요했습니다. 언어별 실제 비용은 이 토큰 수를 스페인어를 포함해 모델별 금액으로 환산하고, 아랍어 토큰 카운터로 자신의 텍스트를 측정할 수 있습니다. 요청마다 콘텐츠 언어를 붙여 토큰을 기록하면, 월별뿐 아니라 사용자별·언어별 비용도 볼 수 있습니다.
마지막으로, 출시 전에 원어민 검수를 받으세요. 기계 번역과 모델 출력은 모두 문법적으로는 맞지만 대상 사용자에게는 어색한 아랍어와 스페인어를 만들어 냅니다. 자기 언어로 제품을 쓰는 검수자는 어떤 테스트도 잡지 못하는 것을 잡아냅니다.
BroadNet Inference는 어디에 맞나요?
BroadRouter는 BroadNet의 자체 사이트입니다. BroadNet Inference의 모델은 아랍어, 영어, 스페인어 제품에 적당히 잘 맞습니다. BroadNet은 Qwen3.8 27B를 걸프·이집트 방언 이해를 포함해 아랍어로 테스트했다고 밝히고 있습니다. Gemma 4 VL 26B는 $5 상당의 초기 크레딧으로 쓸 수 있습니다. 전사는 아랍어(BroadNet Transcribe Arabic, 1분당 $0.0042 요금)와 영어, 스페인어를 포함한 14개 언어(BroadNet Transcribe, 1분당 $0.002 요금)를 지원합니다. 추론 콘텐츠는 보관되지 않으며, 필요한 계정, 결제, 보안 메타데이터는 BroadNet 개인정보 처리방침에 설명된 대로 보관됩니다. 레이아웃, 방향, 형식, 감지에 관한 이 글의 내용은 어떤 API를 쓰든 애플리케이션이 해야 할 일입니다.
