TranscriptionJob - 변환

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

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

TranscriptionJobStatusFAILED인 경우 트랜스크립션 작업 요청이 실패한 이유에 대한 정보가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 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.