Polly에 음성 태그를 보낼 때 대본 내용과 TextType 설정을 함께 맞추기

한 장의 그림으로 이해하기

녹음실의 개념 비유입니다. 왼쪽의 줄무늬 종이와 같은 표시의 출입구는 일반 글과 text 입력 모드, 오른쪽의 꺾쇠 표시 대본과 선택 장치는 SSML 대본과 ssml 모드를 뜻합니다. 작업자가 오른쪽 선택 장치를 돌리는 행동은 대본 외에 입력 형식도 지정하는 과정입니다. 성우가 대본을 보는 모습은 제안 절차이며 실제 Polly 합성 결과나 내부 구조가 아닙니다. 꺾쇠 그림은 완전한 SSML 구문이 아니고, 지원 태그와 엔진 조건은 생략했습니다.
내용의 흐름을 표현한 설명용 그림입니다. 실제 제품 화면이나 실행 결과가 아닙니다.
그림 크게 보기 ↗ (새 탭)

이미지·영상·음성 · 판정 관망

그림을 글로 풀면

대본과 입력 모드 함께 맞추기

Polly의 TextType은 일반 글과 SSML을 구분하며 기본값은 일반 글입니다.

대상
API로 안내 음성을 만드는 개발자와 제작자
무엇이 바뀜
Text의 내용 외에 TextType으로 입력 형식을 지정합니다.
왜 중요한가
태그를 적었다는 사실만으로 요청 설정까지 맞았다고 볼 수 없습니다.
지금 할 일
SSML 대본이면 ssml 모드와 지원 태그를 함께 확인하세요.
한계·미확인
개념 비유. 실제 합성·청취 시험 없음. 모드 지정만으로 모든 태그가 지원되지는 않습니다.
공식 출처
docs.aws.amazon.com
확인일
2026-10-20

대본을 꾸민 뒤 요청 설정도 나란히 보기

가상의 안내 방송 제작에서 쉬는 위치나 발음 지시를 대본에 넣었다면 종이만 확인해서는 요청 준비가 끝나지 않습니다. 그림 오른쪽 작업자는 태그가 표시된 대본과 같은 모양의 선택 장치를 맞춥니다. AINOW는 대본 내용과 입력 형식 설정을 하나의 검토 항목으로 묶도록 제안합니다.

생략한 TextType은 일반 글로 취급됩니다

SynthesizeSpeech 공식 문서에서 TextType은 text 또는 ssml이며 기본값은 일반 글입니다. TextType을 ssml로 지정하면 Text도 SSML 형식을 따라야 합니다. SSML 문자열을 준비하는 단계와 요청의 입력 모드를 지정하는 단계를 구분해 두어야 빠뜨린 설정을 찾기 쉽습니다.

형식이 맞아도 지원 조건과 소리는 확인하기

입력 모드를 맞추는 것만으로 원하는 태그가 선택한 음성·엔진에서 지원되거나 원하는 소리가 나온다고 보장할 수 없습니다. AINOW는 사용할 태그의 공식 지원 안내를 확인하고 짧은 대본으로 합성·청취할 점검 절차를 제안합니다. 이번 글은 API 문서 확인에 근거한 설명이며 실제 요청 전송이나 음성 합성·청취 평가를 수행하지 않았습니다.

참고 원문: AWS 공식 API 문서 — SynthesizeSpeech의 Text와 TextType · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-20

AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.

이 글의 검증 카드

자료 버전
2026-10-20 Polly SynthesizeSpeech API 문서 확인. TextType 기본 text 및 ssml 입력 형식. 합성·청취 시험 없음
확인일
2026-10-20
검증 상태
개발자 주장
한계·주의
개념 비유. 실제 합성·청취 시험 없음. 모드 지정만으로 모든 태그가 지원되지는 않습니다.

함께 더 정확하게

질문·오류 제보

그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.

공개된 질문·제보

    아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.