음성 마크업 언어(SSML) 사용 시 발생하기 쉬운 오류와 회피 방법

2026년 1월 26일

Ondoku에서는 음성 마크업 언어(SSML)를 사용하여 간격 조정이나 낭독 방식의 변화를 줄 수 있습니다.

SSML은 매우 편리한 기능으로, 마음먹은 대로 간격을 조정할 수 있어 많은 분들이 이용하는 기능입니다.

SSML에 대한 자세한 내용은 여기를 확인해 주세요.

음성 마크업 언어(SSML)란? 텍스트 읽어주기 소프트웨어에서의 사용법과 주요 코드 목록. | 텍스트 읽어주기 소프트웨어 Ondoku

SSML이란 음성 마크업 언어를 말합니다. SSML 코드를 작성함으로써 Ondoku의 발성을 더욱 세밀하게 제어할 수 있습니다. Ondoku에서 SSML을 사용하는 방법과 코드를 자세히 소개합니다.

SSML 사용 시 발생하기 쉬운 오류

SSML을 사용하다 보면 오류가 발생하는 경우도 있습니다.

가장 자주 발생하는 오류는

SSML 입력 실수로 "입력한 텍스트에 문제가 있습니다"라고 표시되며 읽을 수 없음.
"크다 작다 브레이크 타임" 등 태그가 기능하지 않고 그대로 읽혀버림.

이는 SSML 입력 실수가 원인이므로 SSML에 오류가 없는지 확인해 주세요.

자주 발생하는 SSML 입력 실수

큰따옴표(")가 전각 문자로 되어 있거나, 비슷하게 생긴 다른 문자로 되어 있음

예: “3s”/>

지정한 숫자나 기호가 전각 문자로 되어 있음

３s"/>

불필요한 기호가 들어가 있음

예: >>

필요한 슬래시나 공백이 없음

<breaktime="3s">

SSML은 예민하여 코드에 단 한 글자라도 실수가 있으면 낭독을 할 수 없게 됩니다.

SSML 오류는 지원 대상이 아닙니다.

문장 건너뛰기
break time 코드 이후의 고저 오류

이러한 오류의 원인은 현재 규명 중입니다.

SSML로 지정할 수 있는 간격·공백은 10초까지

또한 간격·공백을 SSML 태그로 지정할 경우 상한은 10초까지입니다.

그 이상의 시간을 지정한 경우에는 10초로 조정되어 낭독됩니다.

예를 들어

와 같이 10초보다 긴 시간을 지정하면 10초 동안의 간격·공백으로 낭독됩니다.

SSML에서 오류가 발생하는 원인과 회피 방법

현재 파악된 원인은 다음과 같습니다.

브라우저가 Internet Explorer, Microsoft Edge 등 권장되지 않는 환경
3000자를 초과하는 글자 수
SSML 사용 시 기호를 사용함
예: & 「

등입니다.

이러한 오류를 피하는 방법은 세 가지가 있습니다.

권장 환경인 Google Chrome에서 사용하기
적은 글자 수로 낭독한 뒤 결합하기
기호는 사용하지 않기

１．권장 환경인 Google Chrome에서 사용하기

Ondoku의 권장 환경은 Google Chrome입니다.

다른 브라우저에서도 사용할 수 있지만 오류가 발생하기 쉬운 경우가 있습니다.

２．적은 글자 수로 낭독한 뒤 결합하기

123APPS

적은 글자 수로 낭독하면 오류를 피할 수 있습니다.

짧은 MP3 파일로는 활용하기 어려운 경우, 나중에 MP3 파일을 연결합시다.

외부 사이트이지만, 이 사이트에서 MP3 파일끼리 간편하게 결합할 수 있습니다.

외부 사이트: 123APPS

123APPS에 접속
트랙 추가를 클릭
결합하고 싶은 MP3 파일을 넣기
결합을 클릭
완성된 파일을 저장

３．기호는 사용하지 않기

And

SSML 사용 시 기호가 다른 의미를 가지게 되는 경우가 있습니다.

이로 인해 SSML에 간섭하여 낭독이 제대로 되지 않을 수 있습니다.

기호를 사용할 수 없으면 낭독을 할 수 없다

아니요, 그렇지 않습니다.

기호는 히라가나나 가타카나, 알파벳으로 대체함으로써 의도한 대로 낭독할 수 있습니다.

예를 들어

& 은 '앤드'라고 표기할 수 있습니다.
「 은 사용하지 않고 、 등의 구두점으로 대체할 수 있습니다.

그 외의 회피 방법은 수시로 게시하겠습니다.

또한 오류 원인이 밝혀지는 대로 수시로 이 페이지에 보고하겠습니다.

이러한 회피 방법이 있었다거나 이러한 것 때문에 오류가 발생했다는 보고도 기다리고 있겠습니다.

이 기사에 내용을 추가해 나가겠습니다.

■ AI 음성 합성 소프트웨어 「Ondoku」

Ondoku는 초기 비용 0으로 사용할 수 있는 온라인 텍스트 음성 변환 도구입니다.

일본어, 영어, 중국어, 한국어, 스페인어, 프랑스어, 독일어 등 약 50개 언어에 대응
PC·스마트폰 어느쪽에서도 이용 가능
비즈니스·교육·엔터테인먼트 등의 용도에 대응
설치가 필요없고 브라우저에서 즉시 사용 가능
화상으로부터의 독해에도 대응

이용 방법은 사이트에서 텍스트를 입력하거나 파일을 업로드할 뿐. 몇 초 안에 자연스러운 오디오 파일이 생성됩니다. 5,000자까지의 음성 합성이라면 무료로 이용할 수 있으므로, 우선은 한번 시험해 주세요.

텍스트를 음성으로 지금 변환

문장 독서 소프트웨어 "Ondoku"는 무료로 매월 5000자를 AI 음성으로 읽을 수 있습니다. MP3를 쉽게 다운로드할 수 있어 상용 이용도 가능합니다. 무료 등록을 하면 매월 5000자까지 무료로 텍스트를 음성으로 변환할 수 있습니다. 지금 Ondoku를 사용해보십시오.

HP: ondoku3.com
Email: ondoku3.com@gmail.com

←이전 기사 | 다음 기사→