Personal Voices - Post

참조

서비스:: Azure AI Services

API 버전:: 2024-02-01-preview

클라이언트에서 오디오 파일을 사용하여 새 개인 음성을 만듭니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
projectId	formData	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	프로젝트 ID입니다.
audioData	formData		file	오디오 파일.
description	formData		string	이 모델에 대한 선택적 설명입니다.
displayName	formData		string	이 모델의 표시 이름입니다.
properties	formData		string	속성.
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 버전입니다.

요청 헤더

Media Types: "multipart/form-data"

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
201 Created	PersonalVoice	만든 헤더 Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	오류가 발생했습니다. 헤더 x-ms-error-code: string

Name

형식

Description

201 Created

PersonalVoice

만든

헤더

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

오류가 발생했습니다.

헤더

x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

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

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

예제

Create a personal voice

샘플 요청

HTTP

POST {endpoint}/customvoice/personalvoices/Jessica-PersonalVoice?api-version=2024-02-01-preview

샘플 응답

상태 코드:: 201

Operation-Location: https://eastus.api.cognitive.microsoft.com/customvoice/operations/1321a2c0-9be4-471d-83bb-bc3be4f96a6f?api-version=2024-02-01-preview
Operation-Id: 1321a2c0-9be4-471d-83bb-bc3be4f96a6f

{
  "id": "Jessica-PersonalVoice",
  "speakerProfileId": "3059912f-a3dc-49e3-bdd0-02e449df1fe3",
  "projectId": "PersonalVoice",
  "consentId": "Jessica",
  "status": "NotStarted",
  "createdDateTime": "2023-04-01T05:30:00.000Z",
  "lastActionDateTime": "2023-04-02T10:15:30.000Z"
}

정의

Name	Description
AzureBlobContentSource	Azure Blob Storage 콘텐츠. 아래 예제에서는 *.wav https://contoso.blob.core.windows.net/voicecontainer/jessica/파일을 나타냅니다.
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 지침을 따릅니다. 여기에는 필수 속성 오류 코드, 메시지 및 선택적 속성 대상, 내부 오류(중첩될 수 있음)가 포함됩니다.
ModelFailureReason	모델 학습 실패 이유
PersonalVoice	개인 음성 개체
PersonalVoiceProperties	개인 음성 속성
Status	리소스의 상태입니다.

AzureBlobContentSource

Object

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

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

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
BadArgument
BadRequest
Forbidden
InternalServerError
NotFound
ServiceUnavailable
TooManyRequests
Unauthorized
UnsupportedMediaType

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"가 됩니다.

ModelFailureReason

열거형

모델 학습 실패 이유

값	Description
InaccessibleCustomerStorage	고객은 Speech 계정에서 Bring Your Own Storage를 사용합니다. 하지만 지금은 스토리지에 액세스할 수 없습니다. 문서확인하세요.
Internal	사용자 지정 음성 서비스 오류입니다.
SpeakerVerificationFailed	동의 및 학습 오디오는 동일한 스피커에서 온 것이 아닙니다.
TerminateByUser	고객이 모델 학습을 취소했습니다.

PersonalVoice

Object

개인 음성 개체

Name	형식	Description
audios	AzureBlobContentSource	Azure Blob Storage 콘텐츠. 아래 예제에서는 *.wav https://contoso.blob.core.windows.net/voicecontainer/jessica/파일을 나타냅니다.
consentId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	리소스 ID
createdDateTime	string (date-time)	개체를 만든 타임스탬프입니다. 타임스탬프는 ISO 8601 날짜 및 시간 형식으로 인코딩됩니다("YYYY-MM-DDThh:mm:ssZ", https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations참조).
description	string	개인 음성 설명
displayName	string minLength: 1	개인 음성의 표시 이름
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	리소스 ID
lastActionDateTime	string (date-time)	현재 상태가 입력된 타임스탬프입니다. 타임스탬프는 ISO 8601 날짜 및 시간 형식으로 인코딩됩니다("YYYY-MM-DDThh:mm:ssZ", https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations참조).
projectId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	리소스 ID
properties	PersonalVoiceProperties	개인 음성 속성
speakerProfileId	string (uuid)	개인 음성 화자 프로필 ID입니다. SSML에서 이 속성을 채웁니다.
status	Status	리소스의 상태입니다.

PersonalVoiceProperties

Object

개인 음성 속성

Name	형식	Description
failureReason	ModelFailureReason	모델 학습 실패 이유

Status

열거형

리소스의 상태입니다.

값	Description
Disabled
Disabling
Failed
NotStarted
Running
Succeeded

다음을 통해 공유

Personal Voices - Post

URI 매개 변수

요청 헤더

응답

보안

Ocp-Apim-Subscription-Key

예제

Create a personal voice

샘플 요청

샘플 응답

정의

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

추가 리소스