Projects - List Transcriptions

참조

서비스:: Azure AI Services

API 버전:: v3.1

지정된 프로젝트에 대한 전사 목록을 가져옵니다.

GET {endpoint}/speechtotext/v3.1/projects/{id}/transcriptions

선택적 매개 변수:

GET {endpoint}/speechtotext/v3.1/projects/{id}/transcriptions?skip={skip}&top={top}&filter={filter}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).
id	path	True	string (uuid)	프로젝트의 식별자입니다.
filter	query		string	사용 가능한 전사의 하위 집합을 선택하기 위한 필터링 식입니다. `- Supported properties: displayName, description, createdDateTime, lastActionDateTime, status, locale. - Operators: - eq, ne are supported for all properties. - gt, ge, lt, le are supported for createdDateTime and lastActionDateTime. - and, or, not are supported. - Example: filter=createdDateTime gt 2022-02-01T11:00:00Z`
skip	query		integer (int32)	건너뛸 데이터 세트의 수입니다.
top	query		integer (int32)	건너뛴 후 포함할 데이터 세트의 수입니다.

응답

Name	형식	Description
200 OK	PaginatedTranscriptions	그래 헤더 Retry-After: integer
Other Status Codes	Error	오류가 발생했습니다.

Name

형식

Description

200 OK

PaginatedTranscriptions

그래

헤더

Retry-After: integer

Other Status Codes

Error

오류가 발생했습니다.

보안

Ocp-Apim-Subscription-Key

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

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

Authorization

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

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

예제

Get all transcriptions

샘플 요청

HTTP

GET {endpoint}/speechtotext/v3.1/projects/abc46f33-90b8-443d-adad-4870517356e0/transcriptions?skip=0&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z

샘플 응답

상태 코드:: 200

{
  "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
DetailedErrorCode	DetailedErrorCode
DiarizationProperties	DiarizationProperties
DiarizationSpeakersProperties	DiarizationSpeakersProperties
EntityError	EntityError
EntityReference	EntityReference
Error	오류
ErrorCode	오류 코드
InnerError	InnerError
LanguageIdentificationProperties	LanguageIdentificationProperties
PaginatedTranscriptions	PaginatedTranscriptions
ProfanityFilterMode	ProfanityFilterMode
PunctuationMode	PunctuationMode
Status	상태
Transcription	전사
TranscriptionLinks	TranscriptionLinks
TranscriptionProperties	TranscriptionProperties

DetailedErrorCode

열거형

DetailedErrorCode

값	Description
DataImportFailed	데이터 가져오기에 실패했습니다.
DeleteNotAllowed	삭제할 수 없습니다.
DeployNotAllowed	배포가 허용되지 않습니다.
DeployingFailedModel	실패한 모델 배포
EmptyRequest	빈 요청입니다.
EndpointCannotBeDefault	엔드포인트는 기본값일 수 없습니다.
EndpointNotUpdatable	엔드포인트를 업트립할 수 없습니다.
EndpointWithoutLogging	로깅이 없는 엔드포인트입니다.
ExceededNumberOfRecordingsUris	녹음/녹화 URI 수를 초과했습니다.
FailedDataset	실패한 데이터 세트입니다.
Forbidden	금지된.
InUseViolation	사용 위반.
InaccessibleCustomerStorage	액세스할 수 없는 고객 스토리지입니다.
InvalidAdaptationMapping	잘못된 적응 매핑입니다.
InvalidBaseModel	기본 모델이 잘못되었습니다.
InvalidCallbackUri	콜백 URI가 잘못되었습니다.
InvalidCollection	컬렉션이 잘못되었습니다.
InvalidDataset	데이터 세트가 잘못되었습니다.
InvalidDocument	잘못된 문서입니다.
InvalidDocumentBatch	문서 일괄 처리가 잘못되었습니다.
InvalidLocale	잘못된 로캘입니다.
InvalidLogDate	로그 날짜가 잘못되었습니다.
InvalidLogEndTime	로그 종료 시간이 잘못되었습니다.
InvalidLogId	잘못된 로그 ID입니다.
InvalidLogStartTime	로그 시작 시간이 잘못되었습니다.
InvalidModel	잘못된 모델입니다.
InvalidModelUri	모델 URI가 잘못되었습니다.
InvalidParameter	잘못된 매개 변수입니다.
InvalidParameterValue	잘못된 매개 변수 값입니다.
InvalidPayload	잘못된 페이로드입니다.
InvalidPermissions	권한이 잘못되었습니다.
InvalidPrerequisite	필수 구성 요소가 잘못되었습니다.
InvalidProductId	제품 ID가 잘못되었습니다.
InvalidProject	프로젝트가 잘못되었습니다.
InvalidProjectKind	프로젝트 종류가 잘못되었습니다.
InvalidRecordingsUri	잘못된 녹음/녹화 URI입니다.
InvalidRequestBodyFormat	요청 본문 형식이 잘못되었습니다.
InvalidSasValidityDuration	sas 유효 기간이 잘못되었습니다.
InvalidSkipTokenForLogs	로그에 대한 건너뛰기 토큰이 잘못되었습니다.
InvalidSubscription	잘못된 구독입니다.
InvalidTest	테스트가 잘못되었습니다.
InvalidTimeToLive	유효하지 않은 라이브 시간입니다.
InvalidTopForLogs	로그의 위쪽이 잘못되었습니다.
InvalidTranscription	잘못된 전사입니다.
InvalidWebHookEventKind	웹 후크 이벤트 종류가 잘못되었습니다.
MissingInputRecords	입력 레코드가 없습니다.
ModelDeploymentNotCompleteState	모델 배포가 완료되지 않은 상태입니다.
ModelDeprecated	더 이상 사용되지 않는 모델입니다.
ModelExists	모델이 있습니다.
ModelMismatch	모델 불일치.
ModelNotDeployable	모델을 배포할 수 없습니다.
ModelVersionIncorrect	모델 버전이 잘못되었습니다.
NoUtf8WithBom	bom이 있는 utf8이 없습니다.
OnlyOneOfUrlsOrContainerOrDataset	URL 또는 컨테이너 또는 데이터 세트 중 하나만.
ProjectGenderMismatch	프로젝트 성별 불일치.
QuotaViolation	할당량 위반.
SingleDefaultEndpoint	단일 기본 엔드포인트입니다.
SkuLimitsExist	SKU 제한이 있습니다.
SubscriptionNotFound	구독을 찾을 수 없습니다.
UnexpectedError	예기치 않은 오류입니다.
UnsupportedClassBasedAdaptation	지원되지 않는 클래스 기반 적응입니다.
UnsupportedDelta	지원되지 않는 델타입니다.
UnsupportedDynamicConfiguration	지원되지 않는 동적 구성입니다.
UnsupportedFilter	지원되지 않는 필터입니다.
UnsupportedLanguageCode	지원되지 않는 언어 코드입니다.
UnsupportedOrderBy	지원되지 않는 순서 기준입니다.
UnsupportedPagination	지원되지 않는 페이지 매김입니다.
UnsupportedTimeRange	지원되지 않는 시간 범위입니다.

DiarizationProperties

Object

DiarizationProperties

Name	형식	Description
speakers	DiarizationSpeakersProperties	DiarizationSpeakersProperties

DiarizationSpeakersProperties

Object

DiarizationSpeakersProperties

Name	형식	Description
maxCount	integer (int32) minimum: 1	다이어리화를 위한 최대 스피커 수입니다. 36보다 작고 minSpeakers 속성보다 크거나 같아야 합니다.
minCount	integer (int32) minimum: 1	다이어리화를 위한 최소 스피커 수에 대한 힌트입니다. maxSpeakers 속성보다 작거나 같아야 합니다.

EntityError

Object

EntityError

Name	형식	Description
code	string	이 오류의 코드입니다.
message	string	이 오류에 대한 메시지입니다.

EntityReference

Object

EntityReference

Name	형식	Description
self	string (uri)	참조된 엔터티의 위치입니다.

Error

Object

오류

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, 메시지 및 선택적 속성 대상, details(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.
message	string	높은 수준의 오류 메시지입니다.
target	string	오류의 소스입니다. 예를 들어 잘못된 문서의 경우 "문서" 또는 "문서 ID"가 됩니다.

ErrorCode

열거형

오류 코드

값	Description
Conflict	충돌 오류 코드를 나타냅니다.
Forbidden	사용할 수 없는 오류 코드를 나타냅니다.
InternalCommunicationFailed	내부 통신 실패 오류 코드를 나타냅니다.
InternalServerError	내부 서버 오류 코드를 나타냅니다.
InvalidArgument	잘못된 인수 오류 코드를 나타냅니다.
InvalidRequest	잘못된 요청 오류 코드를 나타냅니다.
NotAllowed	허용되지 않는 오류 코드를 나타냅니다.
NotFound	찾을 수 없는 오류 코드를 나타냅니다.
PipelineError	파이프라인 오류 코드를 나타냅니다.
ServiceUnavailable	서비스를 사용할 수 없음 오류 코드를 나타냅니다.
TooManyRequests	너무 많은 요청 오류 코드를 나타냅니다.
Unauthorized	권한 없는 오류 코드를 나타냅니다.
UnprocessableEntity	처리할 수 없는 엔터티 오류 코드를 나타냅니다.
UnsupportedMediaType	지원되지 않는 미디어 형식 오류 코드를 나타냅니다.

InnerError

Object

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, 메시지 및 선택적 속성 대상, details(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.
message	string	높은 수준의 오류 메시지입니다.
target	string	오류의 소스입니다. 예를 들어 잘못된 문서의 경우 "문서" 또는 "문서 ID"가 됩니다.

LanguageIdentificationProperties

Object

LanguageIdentificationProperties

Name	형식	Description
candidateLocales	string[]	언어 식별에 대한 후보 로캘입니다(예: ["en-US", "de-DE", "es-ES"]). 전사의 기본 로캘을 포함하여 최소 2개 및 최대 10개의 후보 로캘이 지원됩니다.
speechModelMapping	<string, EntityReference>	로캘과 음성 모델 엔터티의 선택적 매핑입니다. 로캘에 대해 모델이 지정되지 않은 경우 기본 기본 모델이 사용됩니다. 키는 후보 로캘에 포함된 로캘이어야 하며 값은 해당 로캘의 모델에 대한 엔터티입니다.

PaginatedTranscriptions

Object

PaginatedTranscriptions

Name	형식	Description
@nextLink	string (uri)	사용할 수 있는 엔터티가 더 있는 경우 페이지를 매긴 다음 결과 집합에 대한 링크입니다. 그렇지 않으면 null입니다.
values	Transcription[]	전달된 쿼리 매개 변수 'skip' 및 'top' 또는 해당 기본값으로 제한되는 엔터티 목록입니다. 페이지 매김을 사용하여 목록을 반복하고 엔터티를 병렬로 삭제하는 경우 결과에서 일부 엔터티를 건너뛰게 됩니다. 클라이언트에서 목록을 빌드하고 전체 목록을 페치한 후 삭제하는 것이 좋습니다.

Name

형식

Description

@nextLink

string (uri)

사용할 수 있는 엔터티가 더 있는 경우 페이지를 매긴 다음 결과 집합에 대한 링크입니다. 그렇지 않으면 null입니다.

values

Transcription[]

전달된 쿼리 매개 변수 'skip' 및 'top' 또는 해당 기본값으로 제한되는 엔터티 목록입니다.

페이지 매김을 사용하여 목록을 반복하고 엔터티를 병렬로 삭제하는 경우 결과에서 일부 엔터티를 건너뛰게 됩니다. 클라이언트에서 목록을 빌드하고 전체 목록을 페치한 후 삭제하는 것이 좋습니다.

ProfanityFilterMode

열거형

ProfanityFilterMode

값	Description
Masked	첫 글자(예: f*** 제외)를 *로 욕설 마스크
None	욕설 필터링을 사용하지 않도록 설정합니다.
Removed	욕설을 제거합니다.
Tags	/Profanity><"욕설" XML 태그 추가

PunctuationMode

열거형

PunctuationMode

값	Description
Automatic	자동 문장 부호입니다.
Dictated	받아쓰기된 문장 부호만 표시합니다(예: 명시적 문장 부호).
DictatedAndAutomatic	받아쓰기된 문장 부호 또는 자동 문장 부호입니다.
None	문장 부호가 없습니다.

Status

열거형

상태

값	Description
Failed	장기 실행 작업이 실패했습니다.
NotStarted	장기 실행 작업이 아직 시작되지 않았습니다.
Running	장기 실행 작업은 현재 처리 중입니다.
Succeeded	장기 실행 작업이 성공적으로 완료되었습니다.

Transcription

Object

전사

Name	형식	Description
contentContainerUrl	string (uri)	오디오 파일이 포함된 Azure Blob 컨테이너의 URL입니다. 컨테이너의 최대 크기는 5GB이고 최대 Blob 수는 10000개입니다. Blob의 최대 크기는 2.5GB입니다. 컨테이너 SAS에는 'r'(읽기) 및 'l'(목록) 권한이 포함되어야 합니다. 이 속성은 응답에서 반환되지 않습니다.
contentUrls	string[] (uri)	기록할 오디오 파일을 가져올 콘텐츠 URL 목록입니다. 최대 1,000개의 URL이 허용됩니다. 이 속성은 응답에서 반환되지 않습니다.
createdDateTime	string (date-time)	개체를 만들 때의 타임스탬프를 지정합니다. 타임스탬프는 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 minLength: 1	개체의 표시 이름입니다.
lastActionDateTime	string (date-time)	현재 상태가 입력된 타임스탬프를 지정합니다. 타임스탬프는 ISO 8601 날짜 및 시간 형식으로 인코딩됩니다("YYYY-MM-DDThh:mm:ssZ", https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations참조).
links	TranscriptionLinks	TranscriptionLinks
locale	string minLength: 1	포함된 데이터의 로캘입니다. 언어 식별을 사용하는 경우 이 로캘은 언어를 검색할 수 없는 음성을 전사하는 데 사용됩니다.
model	EntityReference	EntityReference
project	EntityReference	EntityReference
properties	TranscriptionProperties	TranscriptionProperties
self	string (uri)	이 엔터티의 위치입니다.
status	Status	상태 API의 현재 상태 설명

TranscriptionLinks

Object

TranscriptionLinks

Name	형식	Description
files	string (uri)	이 엔터티의 모든 파일을 가져올 위치입니다. 자세한 내용은 "Transcriptions_ListFiles" 작업을 참조하세요.

TranscriptionProperties

Object

TranscriptionProperties

Name	형식	Description
channels	integer[] (int32)	요청된 채널 번호의 컬렉션입니다. 기본 사례에서는 채널 0과 1이 고려됩니다.
destinationContainerUrl	string (uri)	요청된 대상 컨테이너입니다. 비고 대상 컨테이너를 `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`입니다.

다음을 통해 공유

Projects - List Transcriptions

URI 매개 변수

응답

보안

Ocp-Apim-Subscription-Key

Authorization

예제

Get all transcriptions

샘플 요청

샘플 응답

정의

DetailedErrorCode

DiarizationProperties

DiarizationSpeakersProperties

EntityError

EntityReference

Error

ErrorCode

InnerError

LanguageIdentificationProperties

PaginatedTranscriptions

ProfanityFilterMode

PunctuationMode

Status

Transcription

TranscriptionLinks

TranscriptionProperties

비고

추가 리소스