기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GetSpeechSynthesisTask
TaskID를 기반으로 특정 SpeechSynthesisTask 객체를 검색합니다. 이 객체에는 작업 상태, 작업 출력물의 S3 버킷의 링크 등 주어진 스피치 합성 작업에 대한 정보가 포함되어 있습니다.
Request Syntax
GET /v1/synthesisTasks/TaskId
HTTP/1.1
URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
- TaskId
-
Amazon Polly에서 생성한 스피치 합성 작업의 고유 식별자입니다.
패턴:
^[a-zA-Z0-9_-]{1,100}$
필수 사항 여부: Yes
Request Body
해당 요청에는 본문이 없습니다.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"SynthesisTask": {
"CreationTime": number,
"Engine": "string",
"LanguageCode": "string",
"LexiconNames": [ "string" ],
"OutputFormat": "string",
"OutputUri": "string",
"RequestCharacters": number,
"SampleRate": "string",
"SnsTopicArn": "string",
"SpeechMarkTypes": [ "string" ],
"TaskId": "string",
"TaskStatus": "string",
"TaskStatusReason": "string",
"TextType": "string",
"VoiceId": "string"
}
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- SynthesisTask
-
SynthesisTask 출력 형식, 생성 시간, 작업 상태 등을 포함하여 요청된 작업의 정보를 제공하는 객체입니다.
유형: SynthesisTask객체
Errors
- InvalidTaskIdException
-
제공한 작업 ID가 유효하지 않습니다. 유효한 작업 ID를 제공하고 다시 시도하세요.
HTTP 상태 코드: 400
- ServiceFailureException
-
알 수 없는 상태로 인해 서비스 장애가 발생했습니다.
HTTP 상태 코드: 500
- SynthesisTaskNotFoundException
-
요청된 작업 ID가 있는 스피치 합성 작업을 찾을 수 없습니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.