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 minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	리소스의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 헤더

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

요청 본문

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

응답

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

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 콘텐츠. 아래 예에서는 파일을 나타냅니다 `https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav`
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

Object

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

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

Dataset

Object

데이터 세트 개체

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

DatasetKind

열거형

데이터 세트 종류

값	Description
AudioAndScript
LongAudio
AudioOnly

Error

Object

최상위 오류는 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	오류의 소스입니다. 예를 들어 잘못된 모델의 경우 "모델" 또는 "모델 ID"가 됩니다.

ErrorCode

열거형

최상위 오류 코드

값	Description
BadRequest
BadArgument
Unauthorized
Forbidden
NotFound
UnsupportedMediaType
TooManyRequests
InternalServerError
ServiceUnavailable

ErrorResponse

Object

오류 응답은 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

Object

내부 오류는 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	오류의 소스입니다. 예를 들어 잘못된 모델의 경우 "모델" 또는 "모델 ID"가 됩니다.

다음을 통해 공유

Training Sets - Upload Data

URI 매개 변수

요청 헤더

요청 본문

응답

보안

Ocp-Apim-Subscription-Key

예제

Upload data to a training set

샘플 요청

샘플 응답

정의

AzureBlobContentSource

Dataset

DatasetKind

Error

ErrorCode

ErrorResponse

InnerError