DescribeVoices - Amazon Polly
Request SyntaxURI 요청 파라미터Request BodyResponse Syntax응답 요소Errors참고

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

DescribeVoices

스피치 합성을 요청할 때 사용할 수 있는 음성 목록을 반환합니다. 각 음성은 남성 또는 여성의 목소리로 지정된 언어를 사용하며 음성 이름의 ASCII 버전인 ID로 식별합니다.

스피치(SynthesizeSpeech)를 합성할 때는 DescribeVoices에서 반환한 음성 목록에서 원하는 음성의 음성 ID를 입력합니다.

예를 들어 뉴스를 읽어주는 애플리케이션에서 특정 언어로 뉴스를 읽도록 하되 사용자에게 음성을 선택할 수 있는 옵션을 제공할 수 있습니다. 이 DescribeVoices 작업을 사용하여 선택할 수 있는 음성 목록을 사용자에게 제공할 수 있습니다.

필요한 경우 언어 코드를 지정하여 사용 가능한 음성을 필터링할 수 있습니다. 예를 들어, en-US을(를) 지정하는 경우 작업은 사용 가능한 모든 미국 영어 음성의 목록을 반환합니다.

이 작업에는 polly:DescribeVoices 조치를 수행할 권한이 요구됩니다.

Request Syntax

GET /v1/voices?Engine=Engine&IncludeAdditionalLanguageCodes=IncludeAdditionalLanguageCodes&LanguageCode=LanguageCode&NextToken=NextToken HTTP/1.1

URI 요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

Engine

스피치 합성을 위한 입력 텍스트를 처리할 때 Amazon Polly에서 사용하는 엔진(standard, neural 또는 long-form)을 지정합니다.

유효한 값: standard | neural | long-form

IncludeAdditionalLanguageCodes

지정한 언어를 추가 언어로 사용하는 이중 언어 음성의 반환 여부를 나타내는 부울 값입니다. 예를 들어 미국 영어(es-US)를 사용하는 모든 언어를 요청했는데 이탈리아어(it-IT)와 미국 영어를 모두 구사하는 이탈리아어 음성이 있는 경우 yes을(를) 지정하는 경우 해당 음성이 포함되지만 no을(를) 지정하면 포함되지 않습니다.

LanguageCode

반환할 음성 목록을 필터링하기 위한 언어 식별 태그(언어 이름의 경우 ISO 639 코드-ISO 3166 국가 코드)입니다. 이 옵션 파라미터를 지정하지 않으면 사용 가능한 모든 음성을 반환합니다.

유효한 값: arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE

NextToken

이전 DescribeVoices 작업에서 반환한 불투명한 페이지 매김 토큰입니다. 존재하는 경우 이는 목록을 계속해야 할 위치를 나타냅니다.

길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 4096자입니다.

Request Body

해당 요청에는 본문이 없습니다.

Response Syntax

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Voices": [ 
      { 
         "AdditionalLanguageCodes": [ "string" ],
         "Gender": "string",
         "Id": "string",
         "LanguageCode": "string",
         "LanguageName": "string",
         "Name": "string",
         "SupportedEngines": [ "string" ]
      }
   ]
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

NextToken

음성 목록을 계속하기 위해 다음 요청에 사용할 페이지 매김 토큰입니다. 응답이 생략되지 않는 경우에만 NextToken을(를) 반환합니다.

타입: 문자열

길이 제약 조건: 최소 길이는 0입니다. 최대 길이는 4096자입니다.

Voices

음성 및 해당 속성 목록입니다.

타입: Voice 객체 배열

Errors

InvalidNextTokenException

이 ( NextToken 가) 유효하지 않습니다. 철자가 정확한지 확인한 다음 다시 시도하세요.

HTTP 상태 코드: 400

ServiceFailureException

알 수 없는 상태로 인해 서비스 장애가 발생했습니다.

HTTP 상태 코드: 500

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.