Training Sets - Upload Data

서비스:

Azure AI Services

API 버전:

2024-02-01-preview

지정된 학습 집합에 데이터를 업로드합니다.

POST {endpoint}/customvoice/trainingsets/{id}:upload?api-version=2024-02-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://eastus.api.cognitive.microsoft.com).
id	path	True	string	리소스의 ID입니다. regex 패턴: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

요청 헤더

Name	필수	형식	Description
Ocp-Apim-Subscription-Key	True	string	여기에서 Speech 리소스 키를 제공합니다.
Operation-Id		string	작업에 대한 상태 모니터의 ID입니다. Operation-Id 헤더가 기존 작업과 일치하고 요청이 이전 요청과 동일하지 않으면 400 잘못된 요청으로 실패합니다. regex 패턴: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$

요청 본문

Name	필수	형식	Description
audios	True	AzureBlobContentSource	Azure Blob Storage 콘텐츠. 아래 예제에서는 *.wav 파일을https://contoso.blob.core.windows.net/voicecontainer/jessica/ 나타냅니다.
kind	True	DatasetKind	데이터 세트 종류
description		string	이 데이터 세트에 대한 선택적 설명입니다.
displayName		string	이 데이터 세트의 이름입니다.
scripts		AzureBlobContentSource	Azure Blob Storage 콘텐츠. 아래 예제에서는 *.wav 파일을https://contoso.blob.core.windows.net/voicecontainer/jessica/ 나타냅니다.

응답

Name	형식	Description
202 Accepted		수락됨 헤더 Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	오류가 발생했습니다. 헤더 x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

여기에서 Speech 리소스 키를 제공합니다.

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

예제

Upload data to a training set

샘플 요청

HTTP

POST {endpoint}/customvoice/trainingsets/d6916a55-2cbc-4ed4-bd19-739e9a13b0ab:upload?api-version=2024-02-01-preview



{
  "kind": "AudioAndScript",
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".wav"
    ]
  },
  "scripts": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica300/",
    "extensions": [
      ".txt"
    ]
  }
}

샘플 응답

상태 코드:

202

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/284b7e37-f42d-4054-8fa9-08523c3de345?api-version=2024-02-01-preview
Operation-Id: 284b7e37-f42d-4054-8fa9-08523c3de345

정의

Name	Description
AzureBlobContentSource	Azure Blob Storage 콘텐츠. 아래 예제에서는 *.wav 파일을https://contoso.blob.core.windows.net/voicecontainer/jessica/ 나타냅니다.
Dataset	데이터 세트 개체
DatasetKind	데이터 세트 종류
Error	최상위 오류는 에서 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors사용할 수 있는 Microsoft Azure REST API 지침을 따릅니다. 여기에는 오류 코드, 메시지, 세부 정보, 대상 및 보다 설명적인 세부 정보가 포함된 내부 오류가 포함된 최상위 오류가 포함됩니다.
ErrorCode	최상위 오류 코드
ErrorResponse	오류 응답은 에서 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors사용할 수 있는 Microsoft Azure REST API 지침을 따릅니다.
InnerError	내부 오류는 에서 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors사용할 수 있는 Microsoft Azure REST API 지침을 따릅니다. 여기에는 필수 속성 오류 코드, 메시지 및 선택적 속성 대상, 내부 오류(중첩될 수 있음)가 포함됩니다.

AzureBlobContentSource

Azure Blob Storage 콘텐츠. 아래 예제에서는 *.wav 파일을https://contoso.blob.core.windows.net/voicecontainer/jessica/ 나타냅니다.

Name	형식	Description
containerUrl	string	SAS를 사용하는 Azure Blob Storage 컨테이너 URL입니다. 읽기 및 목록 권한이 모두 필요합니다.
extensions	string[]	파일 이름 확장명.
prefix	string	Blob 이름 접두사입니다.

Dataset

데이터 세트 개체

Name	형식	Description
audios	AzureBlobContentSource	Azure Blob Storage 콘텐츠. 아래 예제에서는 *.wav 파일을https://contoso.blob.core.windows.net/voicecontainer/jessica/ 나타냅니다.
description	string	이 데이터 세트에 대한 선택적 설명입니다.
displayName	string	이 데이터 세트의 이름입니다.
kind	DatasetKind	데이터 세트 종류
scripts	AzureBlobContentSource	Azure Blob Storage 콘텐츠. 아래 예제에서는 *.wav 파일을https://contoso.blob.core.windows.net/voicecontainer/jessica/ 나타냅니다.

DatasetKind

데이터 세트 종류

Name	형식	Description
AudioAndScript	string
AudioOnly	string
LongAudio	string

Error

최상위 오류는 에서 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors사용할 수 있는 Microsoft Azure REST API 지침을 따릅니다. 여기에는 오류 코드, 메시지, 세부 정보, 대상 및 보다 설명적인 세부 정보가 포함된 내부 오류가 포함된 최상위 오류가 포함됩니다.

Name	형식	Description
code	ErrorCode	최상위 오류 코드
details	Error[]	오류 및/또는 예상 정책에 대한 추가 지원 세부 정보입니다.
innererror	InnerError	내부 오류는 에서 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors사용할 수 있는 Microsoft Azure REST API 지침을 따릅니다. 여기에는 필수 속성 오류 코드, 메시지 및 선택적 속성 대상, 내부 오류(중첩될 수 있음)가 포함됩니다.
message	string	최상위 오류 메시지입니다.
target	string	오류의 출처입니다. 예를 들어 잘못된 모델의 경우 "model" 또는 "model id"가 됩니다.

ErrorCode

최상위 오류 코드

Name	형식	Description
BadArgument	string
BadRequest	string
Forbidden	string
InternalServerError	string
NotFound	string
ServiceUnavailable	string
TooManyRequests	string
Unauthorized	string
UnsupportedMediaType	string

ErrorResponse

오류 응답은 에서 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors사용할 수 있는 Microsoft Azure REST API 지침을 따릅니다.

Name	형식	Description
error	Error	최상위 오류는 에서 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors사용할 수 있는 Microsoft Azure REST API 지침을 따릅니다. 여기에는 오류 코드, 메시지, 세부 정보, 대상 및 보다 설명적인 세부 정보가 포함된 내부 오류가 포함된 최상위 오류가 포함됩니다.

InnerError

내부 오류는 에서 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors사용할 수 있는 Microsoft Azure REST API 지침을 따릅니다. 여기에는 필수 속성 오류 코드, 메시지 및 선택적 속성 대상, 내부 오류(중첩될 수 있음)가 포함됩니다.

Name	형식	Description
code	string	진단에 도움이 되는 자세한 오류 코드입니다.
innererror	InnerError	내부 오류는 에서 https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors사용할 수 있는 Microsoft Azure REST API 지침을 따릅니다. 여기에는 필수 속성 오류 코드, 메시지 및 선택적 속성 대상, 내부 오류(중첩될 수 있음)가 포함됩니다.
message	string	자세한 오류 메시지입니다.
target	string	오류의 출처입니다. 예를 들어 잘못된 모델의 경우 "model" 또는 "model id"가 됩니다.