다음을 통해 공유


Transcriptions - Create

새 전사를 만듭니다.

POST {endpoint}/speechtotext/v3.1/transcriptions

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
endpoint
path True

string

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).

요청 본문

Name 필수 형식 Description
displayName True

string

개체의 표시 이름입니다.

locale True

string

포함된 데이터의 로캘입니다. 언어 식별을 사용하는 경우 이 로캘은 언어를 검색할 수 없는 음성을 전사하는 데 사용됩니다.

contentContainerUrl

string

오디오 파일이 포함된 Azure Blob 컨테이너의 URL입니다. 컨테이너의 최대 크기는 5GB이고 최대 Blob 수는 1,0000개입니다. Blob의 최대 크기는 2.5GB입니다. 컨테이너 SAS에는 'r'(읽기) 및 'l'(목록) 권한이 포함되어야 합니다. 이 속성은 응답에서 반환되지 않습니다.

contentUrls

string[]

기록할 오디오 파일을 가져오는 콘텐츠 URL 목록입니다. 최대 1,000개의 URL이 허용됩니다. 이 속성은 응답에서 반환되지 않습니다.

customProperties

object

이 엔터티의 사용자 지정 속성입니다. 허용되는 최대 키 길이는 64자, 허용되는 최대 값 길이는 256자, 허용되는 항목 수는 10자입니다.

dataset

EntityReference

EntityReference

description

string

개체에 대한 설명입니다.

links

TranscriptionLinks

TranscriptionLinks

model

EntityReference

EntityReference

project

EntityReference

EntityReference

properties

TranscriptionProperties

TranscriptionProperties

응답

Name 형식 Description
201 Created

Transcription

응답에는 엔터티에 대한 정보가 페이로드로 포함되고 해당 위치가 헤더로 포함됩니다.

헤더

Location: string

Other Status Codes

Error

오류가 발생했습니다.

보안

Ocp-Apim-Subscription-Key

여기에서 Cognitive Services 계정 키를 제공합니다.

형식: apiKey
In(다음 안에): header

Authorization

이 지역의 STS에서 반환된 JWT에서 액세스 토큰을 제공합니다. STS URL에 다음 쿼리 문자열을 추가하여 관리 scope 토큰에 추가해야 합니다. ?scope=speechservicesmanagement

형식: apiKey
In(다음 안에): header

예제

Create a transcription for URIs
Create a transcription from blob container
Create a transcription with basic two-speaker diarization
Create a transcription with language identification
Create a transcription with multispeaker diarization

Create a transcription for URIs

샘플 요청

POST {endpoint}/speechtotext/v3.1/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation",
    "https://contoso.com/myotherstoragelocation"
  ],
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "locale": "en-US",
  "displayName": "Transcription using default model for en-US"
}

샘플 응답

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using adapted model en-US",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription from blob container

샘플 요청

POST {endpoint}/speechtotext/v3.1/transcriptions

{
  "contentContainerUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/audiofiles/",
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "locale": "en-US",
  "displayName": "Transcription of storage container using default model for en-US"
}

샘플 응답

Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683
{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using adapted model en-US",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription with basic two-speaker diarization

샘플 요청

POST {endpoint}/speechtotext/v3.1/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked"
  },
  "locale": "en-US",
  "displayName": "Transcription using basic two-speaker diarization"
}

샘플 응답

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S"
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using basic two-speaker diarization",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription with language identification

샘플 요청

POST {endpoint}/speechtotext/v3.1/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "languageIdentification": {
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b"
        }
      }
    }
  },
  "locale": "fr-FR",
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale."
}

샘플 응답

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": false,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S",
    "languageIdentification": {
      "candidateLocales": [
        "fr-FR",
        "nl-NL",
        "el-GR"
      ],
      "speechModelMapping": {
        "nl-NL": {
          "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b"
        }
      }
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "fr-FR",
  "displayName": "Transcription using language identification with three candidate languages, 'fr-FR' as fallback locale and a custom model for transcribing utterances that were classified as 'nl-NL' locale.",
  "customProperties": {
    "key": "value"
  }
}

Create a transcription with multispeaker diarization

샘플 요청

POST {endpoint}/speechtotext/v3.1/transcriptions

{
  "contentUrls": [
    "https://contoso.com/mystoragelocation"
  ],
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "diarization": {
      "speakers": {
        "minCount": 3,
        "maxCount": 5
      }
    }
  },
  "locale": "en-US",
  "displayName": "Transcription using diarization for audio that is known to contain speech from 3-5 speakers"
}

샘플 응답

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
  "model": {
    "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/models/827712a5-f942-4997-91c3-7c6cde35600b"
  },
  "links": {
    "files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files"
  },
  "properties": {
    "diarizationEnabled": true,
    "wordLevelTimestampsEnabled": false,
    "displayFormWordLevelTimestampsEnabled": false,
    "channels": [
      0,
      1
    ],
    "punctuationMode": "DictatedAndAutomatic",
    "profanityFilterMode": "Masked",
    "duration": "PT42S",
    "diarization": {
      "speakers": {
        "minCount": 3,
        "maxCount": 5
      }
    }
  },
  "lastActionDateTime": "2019-01-07T11:36:07Z",
  "status": "Succeeded",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "locale": "en-US",
  "displayName": "Transcription using diarization for audio that is known to contain speech from 3-5 speakers",
  "customProperties": {
    "key": "value"
  }
}

정의

Name Description
DetailedErrorCode

DetailedErrorCode

DiarizationProperties

DiarizationProperties

DiarizationSpeakersProperties

DiarizationSpeakersProperties

EntityError

EntityError

EntityReference

EntityReference

Error

오류

ErrorCode

오류 코드

InnerError

InnerError

LanguageIdentificationProperties

LanguageIdentificationProperties

ProfanityFilterMode

ProfanityFilterMode

PunctuationMode

PunctuationMode

Status

상태

Transcription

전사

TranscriptionLinks

TranscriptionLinks

TranscriptionProperties

TranscriptionProperties

DetailedErrorCode

DetailedErrorCode

Name 형식 Description
DataImportFailed

string

데이터 가져오기에 실패했습니다.

DeleteNotAllowed

string

삭제할 수 없습니다.

DeployNotAllowed

string

배포가 허용되지 않습니다.

DeployingFailedModel

string

실패한 모델 배포.

EmptyRequest

string

빈 요청.

EndpointCannotBeDefault

string

엔드포인트는 기본값일 수 없습니다.

EndpointNotUpdatable

string

엔드포인트를 사용할 수 없습니다.

EndpointWithoutLogging

string

로깅이 없는 엔드포인트입니다.

ExceededNumberOfRecordingsUris

string

기록 URI 수를 초과했습니다.

FailedDataset

string

실패한 데이터 세트입니다.

Forbidden

string

사용할 수 없습니다.

InUseViolation

string

사용 중 위반.

InaccessibleCustomerStorage

string

액세스할 수 없는 고객 스토리지.

InvalidAdaptationMapping

string

잘못된 적응 매핑입니다.

InvalidBaseModel

string

기본 모델이 잘못되었습니다.

InvalidCallbackUri

string

콜백 URI가 잘못되었습니다.

InvalidCollection

string

컬렉션이 잘못되었습니다.

InvalidDataset

string

데이터 세트가 잘못되었습니다.

InvalidDocument

string

잘못된 문서입니다.

InvalidDocumentBatch

string

잘못된 문서 일괄 처리입니다.

InvalidLocale

string

잘못된 로캘입니다.

InvalidLogDate

string

잘못된 로그 날짜입니다.

InvalidLogEndTime

string

로그 종료 시간이 잘못되었습니다.

InvalidLogId

string

잘못된 로그 ID입니다.

InvalidLogStartTime

string

로그 시작 시간이 잘못되었습니다.

InvalidModel

string

잘못된 모델입니다.

InvalidModelUri

string

모델 URI가 잘못되었습니다.

InvalidParameter

string

잘못된 매개 변수입니다.

InvalidParameterValue

string

매개 변수 값이 잘못되었습니다.

InvalidPayload

string

잘못된 페이로드입니다.

InvalidPermissions

string

권한이 잘못되었습니다.

InvalidPrerequisite

string

필수 구성 요소가 잘못되었습니다.

InvalidProductId

string

잘못된 제품 ID입니다.

InvalidProject

string

프로젝트가 잘못되었습니다.

InvalidProjectKind

string

프로젝트 종류가 잘못되었습니다.

InvalidRecordingsUri

string

잘못된 녹음/녹화 URI입니다.

InvalidRequestBodyFormat

string

잘못된 요청 본문 형식입니다.

InvalidSasValidityDuration

string

sas 유효 기간이 잘못되었습니다.

InvalidSkipTokenForLogs

string

로그에 대한 건너뛰기 토큰이 잘못되었습니다.

InvalidSubscription

string

잘못된 구독입니다.

InvalidTest

string

테스트가 잘못되었습니다.

InvalidTimeToLive

string

유효하지 않은 TL(Time to Live)

InvalidTopForLogs

string

로그의 위쪽이 잘못되었습니다.

InvalidTranscription

string

잘못된 전사입니다.

InvalidWebHookEventKind

string

웹 후크 이벤트 종류가 잘못되었습니다.

MissingInputRecords

string

입력 레코드가 없습니다.

ModelDeploymentNotCompleteState

string

모델 배포가 완료되지 않은 상태입니다.

ModelDeprecated

string

모델이 더 이상 사용되지 않습니다.

ModelExists

string

모델이 있습니다.

ModelMismatch

string

모델 불일치.

ModelNotDeployable

string

모델을 배포할 수 없습니다.

ModelVersionIncorrect

string

모델 버전이 잘못되었습니다.

NoUtf8WithBom

string

bom과 함께 utf8이 없습니다.

OnlyOneOfUrlsOrContainerOrDataset

string

URL 또는 컨테이너 또는 데이터 세트 중 하나만.

ProjectGenderMismatch

string

프로젝트 성별 불일치.

QuotaViolation

string

할당량 위반.

SingleDefaultEndpoint

string

단일 기본 엔드포인트입니다.

SkuLimitsExist

string

SKU 제한이 있습니다.

SubscriptionNotFound

string

구독을 찾을 수 없습니다.

UnexpectedError

string

예기치 않은 오류입니다.

UnsupportedClassBasedAdaptation

string

지원되지 않는 클래스 기반 적응입니다.

UnsupportedDelta

string

지원되지 않는 델타입니다.

UnsupportedDynamicConfiguration

string

지원되지 않는 동적 구성입니다.

UnsupportedFilter

string

지원되지 않는 필터입니다.

UnsupportedLanguageCode

string

지원되지 않는 언어 코드입니다.

UnsupportedOrderBy

string

지원되지 않는 순서 기준입니다.

UnsupportedPagination

string

지원되지 않는 페이지 매김.

UnsupportedTimeRange

string

지원되지 않는 시간 범위입니다.

DiarizationProperties

DiarizationProperties

Name 형식 Description
speakers

DiarizationSpeakersProperties

DiarizationSpeakersProperties

DiarizationSpeakersProperties

DiarizationSpeakersProperties

Name 형식 Description
maxCount

integer

다이어리화를 위한 최대 스피커 수입니다. 36보다 작고 minSpeakers 속성보다 크거나 같아야 합니다.

minCount

integer

다이어리화를 위한 최소 스피커 수에 대한 힌트입니다. maxSpeakers 속성보다 작거나 같아야 합니다.

EntityError

EntityError

Name 형식 Description
code

string

이 오류의 코드입니다.

message

string

이 오류에 대한 메시지입니다.

EntityReference

EntityReference

Name 형식 Description
self

string

참조된 엔터티의 위치입니다.

Error

오류

Name 형식 Description
code

ErrorCode

오류 코드
높은 수준의 오류 코드입니다.

details

Error[]

오류 및/또는 예상 정책에 대한 추가 지원 세부 정보입니다.

innerError

InnerError

InnerError
에서 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow사용할 수 있는 Cognitive Services API 지침을 준수하는 새로운 내부 오류 형식입니다. 여기에는 필수 속성 ErrorCode, 메시지 및 선택적 속성 대상, 세부 정보(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.

message

string

높은 수준의 오류 메시지입니다.

target

string

오류의 출처입니다. 예를 들어 잘못된 문서의 경우 "documents" 또는 "document id"가 됩니다.

ErrorCode

오류 코드

Name 형식 Description
Conflict

string

충돌 오류 코드를 나타냅니다.

Forbidden

string

사용할 수 없는 오류 코드를 나타냅니다.

InternalCommunicationFailed

string

내부 통신 실패 오류 코드를 나타냅니다.

InternalServerError

string

내부 서버 오류 코드를 나타냅니다.

InvalidArgument

string

잘못된 인수 오류 코드를 나타냅니다.

InvalidRequest

string

잘못된 요청 오류 코드를 나타냅니다.

NotAllowed

string

허용되지 않는 오류 코드를 나타냅니다.

NotFound

string

찾을 수 없는 오류 코드를 나타냅니다.

PipelineError

string

파이프라인 오류 오류 코드를 나타냅니다.

ServiceUnavailable

string

서비스를 사용할 수 없음 오류 코드를 나타냅니다.

TooManyRequests

string

너무 많은 요청 오류 코드를 나타냅니다.

Unauthorized

string

권한 없는 오류 코드를 나타냅니다.

UnprocessableEntity

string

처리할 수 없는 엔터티 오류 코드를 나타냅니다.

UnsupportedMediaType

string

지원되지 않는 미디어 형식 오류 코드를 나타냅니다.

InnerError

InnerError

Name 형식 Description
code

DetailedErrorCode

DetailedErrorCode
자세한 오류 코드 열거형입니다.

details

object

오류 및/또는 예상 정책에 대한 추가 지원 세부 정보입니다.

innerError

InnerError

InnerError
에서 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow사용할 수 있는 Cognitive Services API 지침을 준수하는 새로운 내부 오류 형식입니다. 여기에는 필수 속성 ErrorCode, 메시지 및 선택적 속성 대상, 세부 정보(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.

message

string

높은 수준의 오류 메시지입니다.

target

string

오류의 출처입니다. 예를 들어 잘못된 문서의 경우 "documents" 또는 "document id"가 됩니다.

LanguageIdentificationProperties

LanguageIdentificationProperties

Name 형식 Description
candidateLocales

string[]

언어 식별에 대한 후보 로캘입니다(예: ["en-US", "de-DE", "es-ES"]). 대화 내용 기록에 대한 기본 로캘을 포함하여 최소 2개 및 최대 10개의 후보 로캘이 지원됩니다.

speechModelMapping

<string,  EntityReference>

음성 모델 엔터티에 대한 로캘의 선택적 매핑입니다. 로캘에 대해 모델이 지정되지 않은 경우 기본 기본 모델이 사용됩니다. 키는 후보 로캘에 포함된 로캘이어야 하며 값은 해당 로캘의 모델에 대한 엔터티입니다.

ProfanityFilterMode

ProfanityFilterMode

Name 형식 Description
Masked

string

첫 글자를 제외하고 *로 욕설을 마스킹합니다(예: f***).

None

string

욕설 필터링을 사용하지 않도록 설정합니다.

Removed

string

욕설을 제거합니다.

Tags

string

"욕설" XML 태그</욕설 추가>

PunctuationMode

PunctuationMode

Name 형식 Description
Automatic

string

자동 문장 부호입니다.

Dictated

string

받아쓰기된 문장 부호는 명시적 문장 부호만 표시합니다.

DictatedAndAutomatic

string

받아쓰기된 문장 부호 또는 자동 문장 부호입니다.

None

string

문장 부호가 없습니다.

Status

상태

Name 형식 Description
Failed

string

장기 실행 작업이 실패했습니다.

NotStarted

string

장기 실행 작업이 아직 시작되지 않았습니다.

Running

string

장기 실행 작업이 현재 처리 중입니다.

Succeeded

string

장기 실행 작업이 성공적으로 완료되었습니다.

Transcription

전사

Name 형식 Description
contentContainerUrl

string

오디오 파일이 포함된 Azure Blob 컨테이너의 URL입니다. 컨테이너의 최대 크기는 5GB이고 최대 Blob 수는 1,0000개입니다. Blob의 최대 크기는 2.5GB입니다. 컨테이너 SAS에는 'r'(읽기) 및 'l'(목록) 권한이 포함되어야 합니다. 이 속성은 응답에서 반환되지 않습니다.

contentUrls

string[]

기록할 오디오 파일을 가져오는 콘텐츠 URL 목록입니다. 최대 1,000개의 URL이 허용됩니다. 이 속성은 응답에서 반환되지 않습니다.

createdDateTime

string

개체를 만들 때의 타임스탬프를 지정합니다. 타임스탬프는 ISO 8601 날짜 및 시간 형식으로 인코딩됩니다("YYYY-MM-DDThh:mm:ssZ", 참조 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

customProperties

object

이 엔터티의 사용자 지정 속성입니다. 허용되는 최대 키 길이는 64자, 허용되는 최대 값 길이는 256자, 허용되는 항목 수는 10자입니다.

dataset

EntityReference

EntityReference

description

string

개체에 대한 설명입니다.

displayName

string

개체의 표시 이름입니다.

lastActionDateTime

string

현재 상태 입력한 타임스탬프를 지정합니다. 타임스탬프는 ISO 8601 날짜 및 시간 형식으로 인코딩됩니다("YYYY-MM-DDThh:mm:ssZ", 참조 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

links

TranscriptionLinks

TranscriptionLinks

locale

string

포함된 데이터의 로캘입니다. 언어 식별을 사용하는 경우 이 로캘은 언어를 검색할 수 없는 음성을 전사하는 데 사용됩니다.

model

EntityReference

EntityReference

project

EntityReference

EntityReference

properties

TranscriptionProperties

TranscriptionProperties

self

string

이 엔터티의 위치입니다.

status

Status

상태
API의 현재 상태 설명

TranscriptionLinks

Name 형식 Description
files

string

이 엔터티의 모든 파일을 가져올 위치입니다. 자세한 내용은 작업 "Transcriptions_ListFiles"을 참조하세요.

TranscriptionProperties

TranscriptionProperties

Name 형식 Description
channels

integer[]

요청된 채널 번호의 컬렉션입니다. 기본 사례에서는 채널 0과 1이 고려됩니다.

destinationContainerUrl

string

요청된 대상 컨테이너입니다.

설명

대상 컨테이너를 와 함께 timeToLive사용하는 경우 전사의 메타데이터는 정상적으로 삭제되지만 기록 결과를 포함하여 대상 컨테이너에 저장된 데이터는 이 컨테이너에 대한 삭제 권한이 필요하지 않으므로 그대로 유지됩니다.
자동 정리를 지원하려면 컨테이너에서 Blob 수명을 구성하거나 Blob을 정리할 수 있는 대신 destinationContainerUrl"BYOS(Bring Your Own Storage)"를 사용합니다.

diarization

DiarizationProperties

DiarizationProperties

diarizationEnabled

boolean

설사(화자 식별)가 요청되었는지 여부를 나타내는 값입니다. 기본값은 false입니다. 이 필드가 true로 설정되어 있고 를 지정하여 DiarizationProperties향상된 일기 시스템을 구성하는 경우 향상된 일기 시스템은 구성 가능한 범위의 스피커에 대한 일기화를 제공합니다. 이 필드를 true로 설정하고 향상된 설사 시스템을 사용하도록 설정하지 않은 경우(지정 DiarizationProperties하지 않음) 기본 다이어리화 시스템은 최대 2개의 스피커를 구분합니다. 기본 분할에는 추가 요금이 부과되지 않습니다.

기본 분할 시스템은 더 이상 사용되지 않으며 API의 다음 주 버전에서 제거됩니다. 이 diarizationEnabled 설정도 제거됩니다.

displayFormWordLevelTimestampsEnabled

boolean

표시 폼의 단어 수준 타임스탬프가 요청되는지 여부를 나타내는 값입니다. 기본값은 false입니다.

duration

string

전사 기간입니다. 기간은 ISO 8601 기간으로 인코딩됩니다("PnYnMnDTnHnMnS", 참조 https://en.wikipedia.org/wiki/ISO_8601#Durations).

email

string

작업이 완료된 경우 메일 알림 보낼 이메일 주소입니다. 전자 메일을 성공적으로 보낸 후 값이 제거됩니다.

error

EntityError

EntityError

languageIdentification

LanguageIdentificationProperties

LanguageIdentificationProperties

profanityFilterMode

ProfanityFilterMode

ProfanityFilterMode
욕설 필터링 모드입니다.

punctuationMode

PunctuationMode

PunctuationMode
문장 부호에 사용되는 모드입니다.

timeToLive

string

기록을 완료한 후 시스템에 보관할 기간입니다. 전사가 완료 후(성공 또는 실패) 라이브 시간에 도달하면 자동으로 삭제됩니다. 이 값을 설정하지 않거나 0으로 설정하면 자동 삭제가 비활성화됩니다. 지원되는 가장 긴 기간은 31일입니다. 기간은 ISO 8601 기간으로 인코딩됩니다("PnYnMnDTnHnMnS", 참조 https://en.wikipedia.org/wiki/ISO_8601#Durations).

wordLevelTimestampsEnabled

boolean

단어 수준 타임스탬프가 요청되었는지 여부를 나타내는 값입니다. 기본값은 false입니다.