Personal Voices - Create

Referens

Tjänst:: Azure AI Services

API-version:: 2024-02-01-preview

Skapar en ny personlig röst med ljudfiler i Azure Blob Storage.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: 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]$	Resursens ID.
api-version	query	True	string minLength: 1	DEN API-version som ska användas för den här åtgärden.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Ocp-Apim-Subscription-Key	True	string	Ange din Speech-resursnyckel här.
Operation-Id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID för statusövervakaren för åtgärden. Om Operation-Id-huvudet matchar en befintlig åtgärd och begäran inte är identisk med den tidigare begäran misslyckas den med en 400 Felaktig begäran.

Begärandetext

Name	Obligatorisk	Typ	Description
consentId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resurs-ID
projectId	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resurs-ID
audios		AzureBlobContentSource	Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
description		string	Personlig röstbeskrivning
displayName		string minLength: 1	Visningsnamn för personlig röst
id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resurs-ID
status		Status	Status för en resurs.

Svar

Name	Typ	Description
201 Created	PersonalVoice	Skapad Sidhuvuden Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Ett fel uppstod. Sidhuvuden x-ms-error-code: string

Name

Typ

Description

201 Created

PersonalVoice

Skapad

Sidhuvuden

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Ett fel uppstod.

Sidhuvuden

x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Ange din Speech-resursnyckel här.

Typ: apiKey
I: header

Exempel

Create a personal voice

Exempelbegäran

HTTP

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



{
  "projectId": "PersonalVoice",
  "consentId": "Jessica",
  "audios": {
    "containerUrl": "https://contoso.blob.core.windows.net/voicecontainer?mySasToken",
    "prefix": "jessica/",
    "extensions": [
      ".wav"
    ]
  }
}

Exempelsvar

Statuskod:: 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"
}

Definitioner

Name	Description
AzureBlobContentSource	Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Error	Fel på toppnivå följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller ett fel på den översta nivån med felkod, meddelande, information, mål och ett inre fel med mer beskrivande information.
ErrorCode	Felkod på toppnivå
ErrorResponse	Felsvaret följer riktlinjerna för Microsoft Azure REST API som är tillgängliga på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	Inre fel följer riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller nödvändig egenskapsfelkod, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).
ModelFailureReason	Orsak till modellträningsfel
PersonalVoice	Personligt röstobjekt
PersonalVoiceProperties	Personliga röstegenskaper
Status	Status för en resurs.

AzureBlobContentSource

Objekt

Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Name	Typ	Description
containerUrl	string (url)	Url för Azure Blob Storage-container med SAS-. Behöver både läs- och listbehörigheter.
extensions	string[]	Filnamnstillägg.
prefix	string	Prefix för blobnamn.

Error

Objekt

Fel på toppnivå följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller ett fel på den översta nivån med felkod, meddelande, information, mål och ett inre fel med mer beskrivande information.

Name	Typ	Description
code	ErrorCode	Felkod på toppnivå
details	Error[]	Ytterligare stödjande information om fel och/eller förväntade principer.
innererror	InnerError	Inre fel följer riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller nödvändig egenskapsfelkod, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).
message	string	Felmeddelande på den översta nivån.
target	string	Källan till felet. Det skulle till exempel vara "modell" eller "modell-ID" i händelse av en ogiltig modell.

ErrorCode

Uppräkning

Felkod på toppnivå

Värde	Description
BadArgument
BadRequest
Forbidden
InternalServerError
NotFound
ServiceUnavailable
TooManyRequests
Unauthorized
UnsupportedMediaType

ErrorResponse

Objekt

Felsvaret följer riktlinjerna för Microsoft Azure REST API som är tillgängliga på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Typ	Description
error	Error	Fel på toppnivå följer Riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller ett fel på den översta nivån med felkod, meddelande, information, mål och ett inre fel med mer beskrivande information.

InnerError

Objekt

Inre fel följer riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller nödvändig egenskapsfelkod, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).

Name	Typ	Description
code	string	Detaljerad felkod för diagnostik.
innererror	InnerError	Inre fel följer riktlinjerna för Microsoft Azure REST API som finns på https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Detta innehåller nödvändig egenskapsfelkod, meddelande och valfritt egenskapsmål, inre fel (detta kan kapslas).
message	string	Detaljerat felmeddelande.
target	string	Källan till felet. Det skulle till exempel vara "modell" eller "modell-ID" i händelse av en ogiltig modell.

ModelFailureReason

Uppräkning

Orsak till modellträningsfel

Värde	Description
InaccessibleCustomerStorage	Kunden använder Bring Your Own Storage i Speech-kontot. Men lagringen är inte tillgänglig nu. Kontrollera dokument.
Internal	Custom Voice Service-fel.
SpeakerVerificationFailed	Medgivandet och träningsljudet kommer inte från samma talare.
TerminateByUser	Kunden avbröt modellträningen.

PersonalVoice

Objekt

Personligt röstobjekt

Name	Typ	Description
audios	AzureBlobContentSource	Azure Blob Storage-innehåll. Med exemplen nedan representerar den filer https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
consentId	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resurs-ID
createdDateTime	string (date-time)	Tidsstämpeln när objektet skapades. Tidsstämpeln är kodad som ISO 8601-datum- och tidsformat ("ÅÅÅÅ-MM-DDThh:mm:ssZ", se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Personlig röstbeskrivning
displayName	string minLength: 1	Visningsnamn för personlig röst
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	Resurs-ID
lastActionDateTime	string (date-time)	Tidsstämpeln när den aktuella statusen angavs. Tidsstämpeln är kodad som ISO 8601-datum- och tidsformat ("ÅÅÅÅ-MM-DDThh:mm:ssZ", se 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]$	Resurs-ID
properties	PersonalVoiceProperties	Personliga röstegenskaper
speakerProfileId	string (uuid)	Profil-ID för personlig rösthögtalare. Fyll i den här egenskapen i SSML.
status	Status	Status för en resurs.

PersonalVoiceProperties

Objekt

Personliga röstegenskaper

Name	Typ	Description
failureReason	ModelFailureReason	Orsak till modellträningsfel

Status

Uppräkning

Status för en resurs.

Värde	Description
Disabled
Disabling
Failed
NotStarted
Running
Succeeded

Dela via

Personal Voices - Create

URI-parametrar

Begärandehuvud

Begärandetext

Svar

Säkerhet

Ocp-Apim-Subscription-Key

Exempel

Create a personal voice

Exempelbegäran

Exempelsvar

Definitioner

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

Ytterligare resurser