Personal Voices - Post

Riferimento

Servizio:: Azure AI Services

Versione API:: 2024-02-01-preview

Crea una nuova voce personale con file audio nel client.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
projectId	formData	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID progetto.
audioData	formData		file	File audio.
description	formData		string	Descrizione facoltativa di questo modello.
displayName	formData		string	Nome visualizzato di questo modello.
properties	formData		string	proprietà.
endpoint	path	True	string	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: 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 della risorsa.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Media Types: "multipart/form-data"

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string	Specificare la chiave della risorsa Voce qui.
Operation-Id		string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID del monitoraggio dello stato per l'operazione. Se l'intestazione Operation-Id corrisponde a un'operazione esistente e la richiesta non è identica alla richiesta precedente, avrà esito negativo con una richiesta 400 non valida.

Risposte

Nome	Tipo	Descrizione
201 Created	PersonalVoice	Creato Intestazioni Operation-Id: string Operation-Location: string
Other Status Codes	ErrorResponse	Si è verificato un errore. Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

201 Created

PersonalVoice

Creato

Intestazioni

Operation-Id: string
Operation-Location: string

Other Status Codes

ErrorResponse

Si è verificato un errore.

Intestazioni

x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Specificare la chiave della risorsa Voce qui.

Tipo: apiKey
In: header

Esempio

Create a personal voice

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
AzureBlobContentSource	Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav
Error	L'errore di primo livello segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi.
ErrorCode	Codice di errore di primo livello
ErrorResponse	La risposta di errore segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
InnerError	L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno (che può essere annidato).
ModelFailureReason	Motivo dell'errore di training del modello
PersonalVoice	Oggetto voce personale
PersonalVoiceProperties	Proprietà vocali personali
Status	Stato di una risorsa.

AzureBlobContentSource

Object

Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file https://contoso.blob.core.windows.net/voicecontainer/jessica/*.wav

Nome	Tipo	Descrizione
containerUrl	string (url)	URL del contenitore di Archiviazione BLOB di Azure con sas. Sono necessarie autorizzazioni di lettura ed elenco.
extensions	string[]	Estensioni di file.
prefix	string	Prefisso del nome BLOB.

Error

Object

L'errore di primo livello segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi.

Nome	Tipo	Descrizione
code	ErrorCode	Codice di errore di primo livello
details	Error[]	Ulteriori dettagli di supporto relativi all'errore e/o ai criteri previsti.
innererror	InnerError	L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno (che può essere annidato).
message	string	Messaggio di errore di primo livello.
target	string	Origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

ErrorCode

Enumerazione

Codice di errore di primo livello

Valore	Descrizione
BadArgument
BadRequest
Forbidden
InternalServerError
NotFound
ServiceUnavailable
TooManyRequests
Unauthorized
UnsupportedMediaType

ErrorResponse

Object

La risposta di errore segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nome	Tipo	Descrizione
error	Error	L'errore di primo livello segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene un errore di primo livello con codice di errore, messaggio, dettagli, destinazione e errore interno con dettagli più descrittivi.

InnerError

Object

L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno (che può essere annidato).

Nome	Tipo	Descrizione
code	string	Codice di errore dettagliato per facilitare la diagnostica.
innererror	InnerError	L'errore interno segue le linee guida dell'API REST di Microsoft Azure disponibili in https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. Contiene il codice di errore delle proprietà necessarie, la destinazione del messaggio e le proprietà facoltative, l'errore interno (che può essere annidato).
message	string	Messaggio di errore dettagliato.
target	string	Origine dell'errore. Ad esempio, sarebbe "model" o "model id" in caso di modello non valido.

ModelFailureReason

Enumerazione

Motivo dell'errore di training del modello

Valore	Descrizione
InaccessibleCustomerStorage	Il cliente usa Bring Your Own Storage nell'account voce. Ma lo spazio di archiviazione non è ora accessibile. Controllare documento.
Internal	Errore del servizio vocale personalizzato.
SpeakerVerificationFailed	Il consenso e l'audio di training non provengono dallo stesso altoparlante.
TerminateByUser	Il cliente ha annullato il training del modello.

PersonalVoice

Object

Oggetto voce personale

Nome	Tipo	Descrizione
audios	AzureBlobContentSource	Contenuto di Archiviazione BLOB di Azure. Con gli esempi seguenti, rappresenta i file 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]$	ID risorsa
createdDateTime	string (date-time)	Timestamp di creazione dell'oggetto. Il timestamp viene codificato come formato di data e ora ISO 8601 ("AAAA-MM-GGThh:mm:ssZ", vedere https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
description	string	Descrizione vocale personale
displayName	string minLength: 1	Nome visualizzato della voce personale
id	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{1,62}[a-zA-Z0-9]$	ID risorsa
lastActionDateTime	string (date-time)	Timestamp quando è stato immesso lo stato corrente. Il timestamp viene codificato come formato di data e ora ISO 8601 ("AAAA-MM-GGThh:mm:ssZ", vedere 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 risorsa
properties	PersonalVoiceProperties	Proprietà vocali personali
speakerProfileId	string (uuid)	ID profilo voce personale. Compilare questa proprietà in SSML.
status	Status	Stato di una risorsa.

PersonalVoiceProperties

Object

Proprietà vocali personali

Nome	Tipo	Descrizione
failureReason	ModelFailureReason	Motivo dell'errore di training del modello

Status

Enumerazione

Stato di una risorsa.

Valore	Descrizione
Disabled
Disabling
Failed
NotStarted
Running
Succeeded

Condividi tramite

Personal Voices - Post

Parametri dell'URI

Intestazione della richiesta

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

Esempio

Create a personal voice

Esempio di richiesta

Risposta di esempio

Definizioni

AzureBlobContentSource

Error

ErrorCode

ErrorResponse

InnerError

ModelFailureReason

PersonalVoice

PersonalVoiceProperties

Status

Risorse aggiuntive