기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
TranscriptionJob
트랜스크립션 작업에 대한 세부 정보를 제공합니다.
지정된 트랜스크립션 작업의 상태를 보려면TranscriptionJobStatus
필드를 확인하십시오. 상태인 경우 작업이 완료된 것이며 에서 지정한 위치에서 결과를 찾을 수TranscriptFileUri
있습니다.COMPLETED
상태인 경우 트랜스크립션 작업이 실패한 이유에 대한 세부 정보를FailureReason
제공합니다.FAILED
콘텐츠 수정을 활성화한 경우 에 지정된 위치에서 수정된 스크립트를 찾을 수RedactedTranscriptFileUri
있습니다.
목차
- CompletionTime
-
지정한 트랜스크립션 작업이 처리를 완료한 날짜 및 시간입니다.
타임스탬프 형식은 다음과 같습니다
YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC
. 예를 들어,2022-05-04T12:33:13.922000-07:00
는 2022년 5월 4일 UTC-7 오후 12시 33분에 처리를 시작한 트랜스크립션 작업을 나타냅니다.유형: Timestamp
필수 항목 여부: 아니요
- ContentRedaction
-
성적표에 교정이 활성화되었는지 여부를 나타냅니다.
유형: ContentRedaction 객체
필수 항목 여부: 아니요
- CreationTime
-
지정된 트랜스크립션 작업 요청이 이루어진 날짜 및 시간입니다.
타임스탬프 형식은 다음과 같습니다
YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC
. 예를 들어,2022-05-04T12:32:58.761000-07:00
는 2022년 5월 4일 UTC-7 오후 12시 32분에 처리를 시작한 트랜스크립션 작업을 나타냅니다.유형: Timestamp
필수 항목 여부: 아니요
- FailureReason
-
TranscriptionJobStatus
FAILED
인 경우 트랜스크립션 작업 요청이 실패한 이유에 대한 정보가FailureReason
들어 있습니다.FailureReason
필드는 다음 값 중 하나를 포함합니다.-
Unsupported media format
.에서 지정한 미디어 형식이 유효하지
MediaFormat
않습니다. 지원되는 형식 목록은 를 MediaFormat참조하십시오. -
The media format provided does not match the detected media format
.에서 지정한 미디어 형식이 입력 파일의 형식과 일치하지
MediaFormat
않습니다. 미디어 파일의 미디어 형식을 확인하고 지정된 값을 수정합니다. -
Invalid sample rate for audio file
.에 지정된 샘플 레이트가 유효하지
MediaSampleRateHertz
않습니다. 샘플 레이트는 8,000~48,000헤르츠 사이여야 합니다. -
The sample rate provided does not match the detected sample rate
.에 지정된 샘플 레이트가 입력 미디어 파일에서 감지된 샘플 레이트와 일치하지
MediaSampleRateHertz
않습니다. 미디어 파일의 샘플 속도를 확인하고 지정된 값을 수정합니다. -
Invalid file size: file size too large
.미디어 파일의 크기가 Amazon Transcribe에서 처리할 수 있는 크기보다 큽니다. 자세한 내용은 가이드라인 및 할당량을 참조하십시오.
-
Invalid number of channels: number of channels too large
.오디오에는 Amazon Transcribe에서 처리할 수 있는 것보다 더 많은 채널이 포함되어 있습니다. 자세한 내용은 가이드라인 및 할당량을 참조하십시오.
유형: 문자열
필수 항목 여부: 아니요
-
- IdentifiedLanguageScore
-
미디어 파일에서 식별된 언어와 관련된 신뢰도 점수입니다.
신뢰도 점수는 0과 1 사이의 값입니다. 값이 클수록 식별된 언어가 미디어에서 사용되는 언어와 정확하게 일치할 확률이 높습니다.
유형: Float
필수 항목 여부: 아니요
- IdentifyLanguage
-
지정된 트랜스크립션 작업에 대해 자동 언어 식별이 활성화되었는지 여부를 나타냅니다 (
TRUE
).유형: Boolean
필수 항목 여부: 아니요
- IdentifyMultipleLanguages
-
지정된 트랜스크립션 작업에 대해 자동 다중 언어 식별이 활성화되었는지 여부를 나타냅니다 (
TRUE
).유형: Boolean
필수 항목 여부: 아니요
- JobExecutionSettings
-
트랜스크립션 작업이 어떻게 처리되었는지에 대한 정보를 제공합니다. 이 매개변수는 요청이 대기열에 있는지 여부와 사용된 데이터 액세스 역할을 보여줍니다.
유형: JobExecutionSettings 객체
필수 항목 여부: 아니요
- LanguageCode
-
트랜스크립션 작업을 만드는 데 사용되는 언어 코드입니다. 이 매개변수는 단일 언어 식별에 사용됩니다. 다국어 식별 요청의 경우 이 매개변수의 복수 버전을 참조하십시오
LanguageCodes
.유형: String
유효한 값:
af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE
Required: No
- LanguageCodes
-
트랜스크립션 작업을 만드는 데 사용되는 언어 코드입니다. 이 매개변수는 다국어 식별에 사용됩니다. 단일 언어 식별 요청의 경우 이 매개변수의 단일 버전을 참조하십시오
LanguageCode
.유형: LanguageCodeItem 객체 배열
필수 항목 여부: 아니요
- LanguageIdSettings
-
요청에 포함된 모든 사용자 지정 언어 모델, 사용자 지정 어휘 및 사용자 지정 어휘 필터의 이름과 언어를 제공합니다.
유형: String과LanguageIdSettings 객체 맵
맵 항목: 최대 항목 수는 5개입니다.
유효한 키:
af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE
필수 항목 여부: 아니요
- LanguageOptions
-
요청에서 지정한 언어 코드를 제공합니다.
유형: 문자열 배열
배열 멤버: 최소 항목 수는 1개입니다.
유효한 값:
af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE
Required: No
- Media
-
요청에 사용한 미디어 파일의 Amazon S3 위치를 제공합니다.
유형: Media 객체
필수 항목 여부: 아니요
- MediaFormat
-
입력 미디어 파일의 형식입니다.
유형: String
유효한 값:
mp3 | mp4 | wav | flac | ogg | amr | webm
Required: No
- MediaSampleRateHertz
-
입력 미디어 파일에 있는 오디오 트랙의 샘플 속도 (헤르츠) 입니다.
유형: Integer
유효한 범위: 최소값은 8000입니다. 최대값 48,000입니다.
필수 항목 여부: 아니요
- ModelSettings
-
요청에 포함된 사용자 지정 언어 모델에 대한 정보를 제공합니다.
유형: ModelSettings 객체
필수 항목 여부: 아니요
- Settings
-
요청에 포함된 추가 설정에 대한 정보를 제공합니다. 추가 설정에는 채널 식별, 대체 트랜스크립션, 스피커 파티셔닝, 사용자 지정 어휘 및 사용자 지정 어휘 필터가 포함됩니다.
유형: Settings 객체
필수 항목 여부: 아니요
- StartTime
-
지정한 트랜스크립션 작업이 처리를 시작한 날짜 및 시간입니다.
타임스탬프 형식은 다음과 같습니다
YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC
. 예를 들어,2022-05-04T12:32:58.789000-07:00
는 2022년 5월 4일 UTC-7 오후 12시 32분에 처리를 시작한 트랜스크립션 작업을 나타냅니다.유형: Timestamp
필수 항목 여부: 아니요
- Subtitles
-
트랜스크립션과 함께 자막이 생성되었는지 여부를 나타냅니다.
유형: SubtitlesOutput 객체
필수 항목 여부: 아니요
- Tags
-
키:값 페어 형식의 태그는 지정된 트랜스크립션 작업에 할당됩니다.
유형: Tag 객체 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 200개입니다.
필수 항목 여부: 아니요
- Transcript
-
트랜스크립트에 액세스할 때 사용할 수 있는 Amazon S3 URI를 제공합니다.
유형: Transcript 객체
필수 항목 여부: 아니요
- TranscriptionJobName
-
트랜스크립션 작업의 이름입니다. Job 이름은 대소문자를 구분하며 에서 고유해야 합니다AWS 계정.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다.
패턴:
^[0-9a-zA-Z._-]+
필수 항목 여부: 아니요
- TranscriptionJobStatus
-
지정한 트랜스크립션 작업의 상태를 제공합니다.
상태인 경우 작업이 완료된 것이므로 에 지정된 위치
TranscriptFileUri
(또는RedactedTranscriptFileUri
트랜스크립트 수정을 요청한 경우) 에서 결과를 찾을 수 있습니다.COMPLETED
상태인 경우 트랜스크립션 작업이 실패한 이유에 대한 세부 정보를FailureReason
제공합니다.FAILED
유형: String
유효한 값:
QUEUED | IN_PROGRESS | FAILED | COMPLETED
필수 항목 여부: 아니요
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.