Transcriptions - List
인증된 구독에 대한 전사 목록을 가져옵니다.
GET {endpoint}/speechtotext/v3.1/transcriptions
GET {endpoint}/speechtotext/v3.1/transcriptions?skip={skip}&top={top}&filter={filter}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com). |
filter
|
query |
string |
사용 가능한 전사의 하위 집합을 선택하기 위한 필터링 식입니다.
|
|
skip
|
query |
integer int32 |
건너뛸 데이터 세트 수입니다. |
|
top
|
query |
integer int32 |
건너뛴 후 포함할 데이터 세트 수입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 헤더 Retry-After: integer |
|
Other Status Codes |
오류가 발생했습니다. |
보안
Ocp-Apim-Subscription-Key
여기에서 Cognitive Services 계정 키를 제공합니다.
형식:
apiKey
In(다음 안에):
header
Authorization
이 지역의 STS에서 반환된 JWT에서 액세스 토큰을 제공합니다. STS URL에 다음 쿼리 문자열을 추가하여 관리 scope 토큰에 추가해야 합니다. ?scope=speechservicesmanagement
형식:
apiKey
In(다음 안에):
header
예제
Get all failed transcriptions |
Get all transcriptions |
Get all failed transcriptions
샘플 요청
GET {endpoint}/speechtotext/v3.1/transcriptions?skip=0&top=2&filter=status%20eq%20'Failed'
샘플 응답
{
"values": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
"contentUrls": [
"https://contoso.com/",
"https://contoso2.com/"
],
"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": true,
"channels": [
0,
1
],
"punctuationMode": "DictatedAndAutomatic",
"profanityFilterMode": "Masked",
"duration": "PT42S"
},
"lastActionDateTime": "2019-01-07T11:36:07Z",
"status": "Failed",
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "Transcription using adapted model en-US",
"customProperties": {
"key": "value"
}
}
]
}
Get all transcriptions
샘플 요청
GET {endpoint}/speechtotext/v3.1/transcriptions?skip=0&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z
샘플 응답
{
"values": [
{
"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"
}
},
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683",
"contentUrls": [
"https://contoso.com/",
"https://contoso2.com/"
],
"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": true,
"channels": [
0,
1
],
"punctuationMode": "DictatedAndAutomatic",
"profanityFilterMode": "Masked",
"duration": "PT42S"
},
"lastActionDateTime": "2019-01-07T11:36:07Z",
"status": "Failed",
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "Transcription using adapted model en-US",
"customProperties": {
"key": "value"
}
}
],
"@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/transcriptions?skip=2&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z"
}
정의
Name | Description |
---|---|
Detailed |
DetailedErrorCode |
Diarization |
DiarizationProperties |
Diarization |
DiarizationSpeakersProperties |
Entity |
EntityError |
Entity |
EntityReference |
Error |
오류 |
Error |
오류 코드 |
Inner |
InnerError |
Language |
LanguageIdentificationProperties |
Paginated |
PaginatedTranscriptions |
Profanity |
ProfanityFilterMode |
Punctuation |
PunctuationMode |
Status |
상태 |
Transcription |
전사 |
Transcription |
TranscriptionLinks |
Transcription |
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 |
유효하지 않은 라이브 시간입니다. |
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
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 |
오류 코드 |
|
details |
Error[] |
오류 및/또는 예상 정책에 대한 추가 지원 세부 정보입니다. |
innerError |
InnerError |
|
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 |
|
details |
object |
오류 및/또는 예상 정책에 대한 추가 지원 세부 정보입니다. |
innerError |
InnerError |
|
message |
string |
높은 수준의 오류 메시지입니다. |
target |
string |
오류의 출처입니다. 예를 들어 잘못된 문서의 경우 "documents" 또는 "document id"가 됩니다. |
LanguageIdentificationProperties
LanguageIdentificationProperties
Name | 형식 | Description |
---|---|---|
candidateLocales |
string[] |
언어 식별을 위한 후보 로캘입니다(예: ["en-US", "de-DE", "es-ES"]). 대화 내용 기록에 대한 기본 로캘을 포함하여 최소 2개 및 최대 10개의 후보 로캘이 지원됩니다. |
speechModelMapping |
<string,
Entity |
로캘을 음성 모델 엔터티에 대한 선택적 매핑입니다. 로캘에 대해 모델이 제공되지 않으면 기본 기본 모델이 사용됩니다. 키는 후보 로캘에 포함된 로캘이어야 하며 값은 해당 로캘의 모델에 대한 엔터티입니다. |
PaginatedTranscriptions
PaginatedTranscriptions
Name | 형식 | Description |
---|---|---|
@nextLink |
string |
사용할 수 있는 엔터티가 더 있는 경우 페이지를 매긴 다음 결과 집합에 대한 링크입니다. 그렇지 않으면 null입니다. |
values |
전달된 쿼리 매개 변수 'skip' 및 'top' 또는 해당 기본값으로 제한되는 엔터티 목록입니다. 페이지 매김을 사용하여 목록을 반복하고 엔터티를 병렬로 삭제하는 경우 결과에서 일부 엔터티를 건너뛰게 됩니다. 클라이언트에서 목록을 빌드하고 전체 목록을 페치한 후 삭제하는 것이 좋습니다. |
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 |
|
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 |
|
locale |
string |
포함된 데이터의 로캘입니다. 언어 식별을 사용하는 경우 이 로캘은 언어를 검색할 수 없는 음성을 전사하는 데 사용됩니다. |
model |
EntityReference |
|
project |
EntityReference |
|
properties |
TranscriptionProperties |
|
self |
string |
이 엔터티의 위치입니다. |
status |
상태 |
TranscriptionLinks
TranscriptionLinks
Name | 형식 | Description |
---|---|---|
files |
string |
이 엔터티의 모든 파일을 가져올 위치입니다. 자세한 내용은 작업 "Transcriptions_ListFiles"을 참조하세요. |
TranscriptionProperties
TranscriptionProperties
Name | 형식 | Description |
---|---|---|
channels |
integer[] |
요청된 채널 번호의 컬렉션입니다. 기본 사례에서는 채널 0과 1이 고려됩니다. |
destinationContainerUrl |
string |
요청된 대상 컨테이너입니다. 설명대상 컨테이너를 와 함께 |
diarization |
DiarizationProperties |
|
diarizationEnabled |
boolean |
설사(화자 식별)가 요청되었는지 여부를 나타내는 값입니다. 기본값은 기본 분할 시스템은 더 이상 사용되지 않으며 API의 다음 주 버전에서 제거됩니다.
이 |
displayFormWordLevelTimestampsEnabled |
boolean |
표시 폼의 단어 수준 타임스탬프가 요청되는지 여부를 나타내는 값입니다. 기본값은 |
duration |
string |
전사 기간입니다. 기간은 ISO 8601 기간으로 인코딩됩니다("PnYnMnDTnHnMnS", 참조 https://en.wikipedia.org/wiki/ISO_8601#Durations). |
string |
작업이 완료되는 경우 메일 알림 보낼 이메일 주소입니다. 전자 메일을 성공적으로 보낸 후 값이 제거됩니다. |
|
error |
EntityError |
|
languageIdentification |
LanguageIdentificationProperties |
|
profanityFilterMode |
ProfanityFilterMode |
|
punctuationMode |
PunctuationMode |
|
timeToLive |
string |
기록을 완료한 후 시스템에 보관할 기간입니다. 전사가 완료 후(성공 또는 실패) 라이브 시간에 도달하면 자동으로 삭제됩니다. 이 값을 설정하지 않거나 0으로 설정하면 자동 삭제가 비활성화됩니다. 지원되는 가장 긴 기간은 31일입니다. 기간은 ISO 8601 기간으로 인코딩됩니다("PnYnMnDTnHnMnS", 참조 https://en.wikipedia.org/wiki/ISO_8601#Durations). |
wordLevelTimestampsEnabled |
boolean |
단어 수준 타임스탬프가 요청되었는지 여부를 나타내는 값입니다. 기본값은 |